PCW_COUNTER_DESCRIPTOR-Struktur (wdm.h)
Die PCW_COUNTER_DESCRIPTOR -Struktur wird verwendet, um Informationen zu einem Zählerwert während der Countersetregistrierung bereitzustellen. Die meisten Entwickler müssen nicht direkt auf diese Struktur zugreifen, da sie automatisch vom Vom CTRPP-Tool generierten Registrierungscode für das Gegenset verwaltet wird.
Syntax
typedef struct _PCW_COUNTER_DESCRIPTOR {
USHORT Id;
USHORT StructIndex;
USHORT Offset;
USHORT Size;
} PCW_COUNTER_DESCRIPTOR, *PPCW_COUNTER_DESCRIPTOR;
Member
Id
Ein numerischer Wert, der die ID des von dieser Struktur beschriebenen Zählers angibt. Dies sollte mit dem Wert übereinstimmen, der id im Feld eines Zählerelements im Gegensatzmanifest des Anbieters angegeben wird.
StructIndex
Ein numerischer Wert, der einen Index in ein Array von PCW_DATA Strukturen angibt. Bei nachfolgenden Aufrufen PcwCreateInstance von oder PcwAddInstancewird der von PcwData[PcwCounterDescriptor->StructIndex] beschriebene Datenblock als Datenquelle für den Zähler mit der ID PcwCounterDescriptor->Idverwendet.
Offset
Ein numerischer Wert, der einen Offset (in Bytes) relativ zum vom StructIndex Feld angegebenen Datenblock angibt. Bei nachfolgenden Aufrufen PcwCreateInstance von oder PcwAddInstancewird die Adresse PcwData[PcwCounterDescriptor->StructIndex].Data + PcwCounterDescriptor->Offset als Anfang des Werts für den Zähler mit der ID PcwCounterDescriptor->Idverwendet.
Size
Ein numerischer Wert, der die Größe des Werts für den Zähler mit der ID PcwCounterDescriptor->Idin Bytes angibt. Das Size Feld sollte auf 4 (für einen UINT32 Zählerwert) oder 8 (für einen UINT64 Zählerwert) festgelegt werden.
Hinweise
Die meisten Entwickler müssen diese Struktur nicht direkt verwenden. Das CTRPP Tool generiert Registrierungscode, der Strukturen basierend auf dem Inhalt des Anbietermanifests PCW_COUNTER_DESCRIPTOR initialisiert.
Ein Array von Strukturen wird während der PCW_COUNTER_DESCRIPTOR Countersetregistrierung bereitgestellt (über die an übergebene PcwRegisterPCW_REGISTRATION_INFORMATION-Struktur). Die Informationen aus dem Array werden aufgezeichnet und von PcwCreateInstance oder PcwAddInstance verwendet, um Zählerwerte aus den datenblöcken zu extrahieren, die von einem PCW_DATA Array beschrieben werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 7 und späteren Windows-Versionen. |
| Kopfzeile | wdm.h (include Wdm.h, Ntddk.h) |