PCW_COUNTER_DESCRIPTOR Struktur (wdm.h)
Die PCW_COUNTER_DESCRIPTOR-Struktur wird verwendet, um Informationen zu einem Leistungsindikatorwert während der Gegensatzregistrierung bereitzustellen. Die meisten Entwickler müssen nicht direkt auf diese Struktur zugreifen, da sie automatisch vom Gegensatzregistrierungscode verwaltet wird, der vom CTRPP Tool generiert wird.
Syntax
typedef struct _PCW_COUNTER_DESCRIPTOR {
USHORT Id;
USHORT StructIndex;
USHORT Offset;
USHORT Size;
} PCW_COUNTER_DESCRIPTOR, *PPCW_COUNTER_DESCRIPTOR;
Angehörige
Id
Ein numerischer Wert, der die ID des Zählers angibt, der durch diese Struktur beschrieben wird. Dies sollte mit dem Wert übereinstimmen, der im Feld id eines Indikators Element im Gegensatzmanifest des Anbieters bereitgestellt wird.
StructIndex
Ein numerischer Wert, der einen Index in einem Array von PCW_DATA Strukturen angibt. Bei nachfolgenden Aufrufen von PcwCreateInstance oder PcwAddInstancewird der von PcwData[PcwCounterDescriptor->StructIndex] beschriebene Datenblock als Datenquelle für den Zähler mit ID-PcwCounterDescriptor->Idverwendet.
Offset
Ein numerischer Wert, der einen Offset (in Byte) relativ zum durch das feld StructIndex angegebenen Datenblock angibt. Bei nachfolgenden Aufrufen von PcwCreateInstance oder PcwAddInstancewird die Adresse PcwData[PcwCounterDescriptor->StructIndex].Data + PcwCounterDescriptor->Offset als Anfang des Werts für den Zähler mit id PcwCounterDescriptor->Idverwendet.
Size
Ein numerischer Wert, der die Größe des Werts für den Zähler in Byte mit der ID PcwCounterDescriptor->Idangibt. Das feld Size sollte auf 4 (für einen UINT32 Zählerwert) oder 8 (für einen UINT64 Indikatorwert) festgelegt werden.
Bemerkungen
Die meisten Entwickler müssen diese Struktur nicht direkt verwenden. Das CTRPP Tool generiert Registrierungscode, der PCW_COUNTER_DESCRIPTOR Strukturen basierend auf dem Inhalt des Anbietermanifests initialisiert.
Ein Array von PCW_COUNTER_DESCRIPTOR Strukturen wird während der Gegensatzregistrierung bereitgestellt (über die an PcwRegisterübergebene PCW_REGISTRATION_INFORMATION-Struktur). Die Informationen aus dem Array werden aufgezeichnet und von PcwCreateInstance oder PcwAddInstance verwendet, um Gegenwerte aus den durch ein PCW_DATA Array beschriebenen Datenblöcken zu extrahieren.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows 7 und höheren Versionen von Windows. |
| Header- | wdm.h (include Wdm.h, Ntddk.h) |