Export (0) Print
Expand All
IRP
MDL
Expand Minimize
This topic has not yet been rated - Rate this topic

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

Ntddk.h (include Ntddk.h or Ntifs.h)

See also

PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR_TYPE
PHYSICAL_COUNTER_RESOURCE_LIST

 

 

Send comments about this topic to Microsoft

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.