Export (0) Print
Expand All

2.2.4.1 _PERF_COUNTERSET_REG_INFO

The _PERF_COUNTERSET_REG_INFO structure contains information about the counterset and is used when enumerating performance counter information about the server.

 typedef struct _PERF_COUNTERSET_REG_INFO {
   GUID CounterSetGuid;
   unsigned long CounterSetType;
   unsigned long DetailLevel;
   unsigned long NumCounters;
   unsigned long InstanceType;
 } PERF_COUNTERSET_REG_INFO,
  *PPERF_COUNTERSET_REG_INFO;

CounterSetGuid: A GUID uniquely identifying the counterset.

CounterSetType: Unused. MUST be set to 0, and MUST be ignored on receipt.

DetailLevel: The detail level of the counterset that is used to indicate the intended target audience. The value MUST be one of the following.

Value

Meaning

0x00000064

Novice level. Designed to be accessed by casual users who do not have detailed system knowledge.

0x000000C8

Advanced level. Designed to be accessed by information technology (IT) administrators who are monitoring multiple machines.

NumCounters: The number of counters that are defined in the counterset.

InstanceType: There can be a single or multiple active instances of the counterset, and the client must handle these instances differently. A single active instance of a counterset corresponds to a single active instance of a performance counter within that counterset. This field indicates whether the counterset is single, aggregate, or multiple-instance. The value MUST be one of the following.

Value

Meaning

0x00000000

Single instance. Only one instance of the counterset is active on the system at any time while the system is running.

0x00000002

Multiple instances. There can be several instances of the counterset active on the system at any time while the system is running.

0x00000004

Global aggregate. Performs an aggregation operation that is specified in the performance counter definition. The aggregation operation is performed on the client side for each counter in the counterset across all available and active instances of the counterset in the system.

0x00000006

Multiple-instance aggregate. Performs an aggregation operation that is specified in the performance counter definition. The aggregation operation is performed on the client side for each performance counter in the counterset across a client-specified set of instances of that counterset. For example, a client can average the value of counter "A" from counterset instances "1", "2", and "5".

0x0000000C

Global aggregate history. Performs an aggregation operation that is specified in the counter definition. The aggregation operation is performed on the client side for each performance counter in the counterset across all available instances of the counterset. The result of the aggregation operation can then be cached by the consumer and referenced for later use. For example, if a counter is deleted by the server between client queries, the client can use the value of the counter that was obtained in the last query for the aggregation operation.

0x00000016

Instance aggregate. Not implemented.

Show:
© 2016 Microsoft