PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR structure
The PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR structure describes the counter resources available on the platform.
Syntax
typedef struct _PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR { PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR_TYPE Type; ULONG Flags; union { ULONG CounterIndex; ULONG ExtendedRegisterAddress; struct { ULONG Begin; ULONG End; } Range; } u; } PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR, *PPHYSICAL_COUNTER_RESOURCE_DESCRIPTOR;
Members
- Type
-
Indicates the type of counter resource described by the structure. Set this parameter to one of the following PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR_TYPE enumeration constants:
-
ResourceTypeSingle
-
ResourceTypeRange
-
ResourceTypeExtendedCounterConfiguration
-
ResourceTypeOverflow
-
- Flags
-
No flags are currently defined. Set this member to zero.
- u
-
A union that can contain a CounterIndex, ExtendedRegisterAddress, or Range value.
- CounterIndex
-
A physical counter index.
- ExtendedRegisterAddress
-
An extended configuration register address.
- Range
-
A range of counter indexes.
- Begin
-
The starting counter index of a block of contiguous counters.
- End
-
The ending counter index of a block of contiguous counters.
Remarks
Most processors have performance monitor units that contain a number of hardware counters for measuring various aspects of system performance. The PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR structure describes a counter resource, which can be a single hardware counter, a block of contiguous counters, or a counter overflow interrupt. This structure's Type member indicates which type of counter resource is described by the structure.
To specify a set of counter resources, a kernel-mode client can provide an array of PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR structures. A PHYSICAL_COUNTER_RESOURCE_LIST structure serves as a header for the array. The client can allocate and free the set of counter resources described by the array as a single unit.
Requirements
|
Version | Supported in Windows 7 and later versions of Windows. |
|---|---|
|
Header |
|
See also
Send comments about this topic to Microsoft
Build date: 5/22/2013
