ATL Performance Monitor Counter Wizard
This wizard inserts a performance monitor counter as a variable into an object containing a performance monitor object manager and a performance object. Nonattributed projects must contain a counter map (which is added automatically by the ATL Performance Object Wizard), specifying the name of the variable, its type, and its human-readable name and help string. Additionally, you can specify:
The level of user you expect to collect the data.
The exponential value, indicating the top level of the counter scale.
- Variable type
Indicate the variable type for the counter. The type you select determines which Counter type you can create.
Variable type Description
A 32-bit unsigned integer.
A 64-bit unsigned integer.
- Variable name
Sets the name of the member variable you are adding. In the MMC Console application provided with Windows 2000, this name appears in the counter list in the Add Counters dialog box.
- Counter type
Sets the type of calculations the counter performs. Select one of the types from the list. The option you select for Variable type determines which counter types are displayed in the list. For a description of each type, see:
For non-attributed projects, the type you select is implemented as the countertype parameter in the DEFINE_COUNTER macro, in the CPerfObject derived class in your project. In an attributed project, countertype is passed as a parameter in the perf_counter attribute.
The counter types and data structures are defined in WINPERF.H.
Each counter type is implemented in the counter attribute for attributed projects, or in the counter macro map for nonattributed projects.
- Name string
Sets the human-readable name for the counter.
- Help string
Sets the help string for the counter. This string length has no upper limit.
In the MMC console application provided with Windows 2000, users can view a counter's help string by opening the Add Counters dialog box, highlighting the appropriate counter, and clicking the Explain button.
- Detail level
Indicates the level of information provided to the user. Your selection is specified in a DWORD and sent to the performance monitor, as is the detail level you specify in the ATL Performance Object Wizard.
- Default scale
Indicates the power of 10 by which to multiply the counter value before displaying the counter. For example, if you set Default scale to 2, the counter value is multiplied by 100. If you set Default scale to –3, the counter value is divided by 1,000.
- Default counter
Sets this counter as the default counter for the performance object. In the MMC Console application provided with Windows 2000 and above, this counter name appears as the default selection in the counter list in the Add Counters dialog box.