PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR-Struktur (ntddk.h)
Die PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR-Struktur beschreibt die auf der Plattform verfügbaren Leistungsindikatorenressourcen.
Syntax
typedef struct _PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR {
PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR_TYPE Type;
ULONG Flags;
union {
ULONG CounterIndex;
struct {
ULONG Begin;
ULONG End;
} Range;
PPHYSICAL_COUNTER_OVERFLOW_HANDLER OverflowHandler;
PHYSICAL_COUNTER_EVENT_BUFFER_CONFIGURATION EventBufferConfiguration;
ULONG IdentificationTag;
} u;
} PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR, *PPHYSICAL_COUNTER_RESOURCE_DESCRIPTOR;
Member
Type
Gibt den Typ der Zählerressource an, die von der -Struktur beschrieben wird. Legen Sie diesen Parameter auf eine der folgenden PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR_TYPE Enumerationskonstanten fest:
- ResourceTypeSingle
- ResourceTypeRange
- ResourceTypeOverflow
- ResourceTypeEventBuffer
Flags
Derzeit sind keine Flags definiert. Legen Sie dieses Element auf 0 fest.
u
Eine Union, die einen CounterIndex-, Range-, OverflowHandler- oder EventBufferConfiguration-Wert enthalten kann.
u.CounterIndex
Ein physischer Indikatorindex.
u.Range
Ein Bereich von Zählerindizes.
u.Range.Begin
Der Anfangsindikatorindex eines Blocks zusammenhängender Zähler.
u.Range.End
Der endende Zählerindex eines Blocks zusammenhängender Zähler.
u.OverflowHandler
Ein Zeiger auf die vom Treiber bereitgestellte PPHYSICAL_COUNTER_OVERFLOW_HANDLER Routine, die aufgerufen wird, wenn ein zugeordneter Hardwareindikator (angegeben durch einen anderen PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR) überläuft.
u.EventBufferConfiguration
Eine Konfiguration für ereignispufferbasierte Stichprobenerstellung (z. B. PEBS von Intel). Die Konfigurationsfelder werden durch den PHYSICAL_COUNTER_EVENT_BUFFER_CONFIGURATION-Typ definiert.
u.IdentificationTag
Hinweise
Die meisten Prozessoren verfügen über Leistungsüberwachungseinheiten, die eine Reihe von Hardwareindikatoren zum Messen verschiedener Aspekte der Systemleistung enthalten. Die PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR-Struktur beschreibt eine Zählerressource, bei der es sich um einen einzelnen Hardwareindikator, einen Block zusammenhängender Zähler, einen Counterüberlauf-Interrupt oder eine Ereignispufferkonfiguration handelt. Das Type-Element dieser Struktur gibt an, welcher Typ der Zählerressource von der -Struktur beschrieben wird.
Um eine Reihe von Indikatorenressourcen anzugeben, kann ein Kernelmodusclient ein Array von PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR-Strukturen bereitstellen. Eine PHYSICAL_COUNTER_RESOURCE_LIST-Struktur dient als Header für das Array. Der Client kann den Satz von Zählerressourcen, die vom Array beschrieben werden, als einzelne Einheit zuordnen und freigeben. Dazu ruft der Treiber HalAllocateHardwareCounters und HalFreeHardwareCounters auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Unterstützt in Windows 7 und höheren Versionen von Windows. |
| Kopfzeile | ntddk.h (include Ntddk.h, Ntifs.h) |