struttura PCW_COUNTER_DESCRIPTOR (wdm.h)
La struttura PCW_COUNTER_DESCRIPTOR viene utilizzata per fornire informazioni su un valore del contatore durante la registrazione del contatore. La maggior parte degli sviluppatori non deve accedere direttamente a questa struttura perché viene gestita automaticamente dal codice di registrazione del contatore generato dallo strumento di CTRPP.
Sintassi
typedef struct _PCW_COUNTER_DESCRIPTOR {
USHORT Id;
USHORT StructIndex;
USHORT Offset;
USHORT Size;
} PCW_COUNTER_DESCRIPTOR, *PPCW_COUNTER_DESCRIPTOR;
Membri
Id
Valore numerico che specifica l'ID del contatore descritto da questa struttura. Deve corrispondere al valore specificato nel campo id di un contatore elemento nel manifesto del contatore del provider.
StructIndex
Valore numerico che specifica un indice in una matrice di strutture PCW_DATA. Nelle chiamate successive a PcwCreateInstance o PcwAddInstance, il blocco di dati descritto da PcwData[PcwCounterDescriptor->StructIndex] verrà usato come origine dei dati per il contatore con ID PcwCounterDescriptor->Id.
Offset
Valore numerico che specifica un offset (in byte) relativo al blocco di dati indicato dal campo StructIndex. Nelle chiamate successive a PcwCreateInstance o PcwAddInstance, l'indirizzo PcwData[PcwCounterDescriptor->StructIndex].Data + PcwCounterDescriptor->Offset verrà usato come inizio del valore per il contatore con ID PcwCounterDescriptor->Id.
Size
Valore numerico che specifica le dimensioni, in byte, del valore per il contatore con ID PcwCounterDescriptor->Id. Il campo Size deve essere impostato su 4 (per un valore del contatore UINT32) o 8 (per un valore del contatore UINT64).
Osservazioni
La maggior parte degli sviluppatori non deve usare direttamente questa struttura. Lo strumento CTRPP genera codice di registrazione che inizializza PCW_COUNTER_DESCRIPTOR strutture in base al contenuto del manifesto del provider.
Durante la registrazione del contatore viene fornita una matrice di strutture di PCW_COUNTER_DESCRIPTOR (tramite la struttura PCW_REGISTRATION_INFORMATION passata a PcwRegister). Le informazioni della matrice vengono registrate e verranno usate da PcwCreateInstance o PcwAddInstance per estrarre i valori dei contatori dai blocchi di dati descritti da una matrice di PCW_DATA.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Windows 7 e versioni successive di Windows. |
| intestazione | wdm.h (include Wdm.h, Ntddk.h) |
Vedere anche
_PCW_REGISTRATION_INFORMATION struttura
contatore tipo complesso