PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR Struktur (ntddk.h)
In der PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR-Struktur werden die Leistungsressourcen beschrieben, die auf der Plattform verfügbar sind.
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;
Angehörige
Type
Gibt den Typ der Zählerressource an, die durch die Struktur beschrieben wird. Legen Sie diesen Parameter auf eine der folgenden PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR_TYPE Enumerationskonstanten fest:
- ResourceTypeSingle-
- ResourceTypeRange-
- ResourceTypeOverflow-
- ResourceTypeEventBuffer-
Flags
Zurzeit sind keine Flags definiert. Legen Sie dieses Element auf Null fest.
u
Eine Vereinigung, die einen CounterIndex-, Range, OverflowHandler-oder EventBufferConfiguration- wert enthalten kann.
u.CounterIndex
Ein physischer Leistungsindikatorindex.
u.Range
Ein Bereich von Zählerindizes.
u.Range.Begin
Der Anfangsindikatorindex eines Blocks zusammenhängender Zähler.
u.Range.End
Der Endzä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 Hardwarezähler (angegeben durch einen anderen PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR) überläuft.
u.EventBufferConfiguration
Eine Konfiguration für ereignispufferbasierte Samplings (z. B. PEBS von Intel). Die Konfigurationsfelder werden vom PHYSICAL_COUNTER_EVENT_BUFFER_CONFIGURATION Typ definiert.
u.IdentificationTag
Bemerkungen
Die meisten Prozessoren verfügen über Leistungsüberwachungseinheiten, die eine Reihe von Hardwarezählern zum Messen verschiedener Aspekte der Systemleistung enthalten. Die PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR-Struktur beschreibt eine Leistungsressource, die ein einzelner Hardwarezähler, ein Block zusammenhängender Leistungsindikatoren, ein Überlaufunterbruch oder eine Ereignispufferkonfiguration sein kann. Der Type Member dieser Struktur gibt an, welcher Typ der Zählerressource durch die Struktur beschrieben wird.
Um eine Reihe von Leistungsindikatorenressourcen anzugeben, kann ein Kernelmodusclient ein Array von PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR Strukturen bereitstellen. Eine PHYSICAL_COUNTER_RESOURCE_LIST Struktur dient als Kopfzeile für das Array. Der Client kann den Satz von Leistungsindikatorenressourcen zuordnen und freigeben, die vom Array als einzelne Einheit beschrieben werden. Dazu ruft der Treiber HalAllocateHardwareCounters und HalFreeHardwareCounters
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Unterstützt in Windows 7 und höheren Versionen von Windows. |
| Header- | ntddk.h (enthalten Ntddk.h, Ntifs.h) |