PCW_COUNTER_DESCRIPTOR struttura (wdm.h)
La PCW_COUNTER_DESCRIPTOR struttura viene usata 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 contatore generato dallo strumento CTRPP .
Sintassi
typedef struct _PCW_COUNTER_DESCRIPTOR {
USHORT Id;
USHORT StructIndex;
USHORT Offset;
USHORT Size;
} PCW_COUNTER_DESCRIPTOR, *PPCW_COUNTER_DESCRIPTOR;
Members
Id
Valore numerico che specifica l'ID del contatore descritto da questa struttura. Deve corrispondere al valore specificato nel id campo di un elemento contatore 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) rispetto al blocco di dati indicato dal StructIndex campo. 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 Size campo deve essere impostato su 4 (per un UINT32 valore del contatore) o 8 (per un UINT64 valore del contatore).
Commenti
La maggior parte degli sviluppatori non deve usare direttamente questa struttura. Lo CTRPP strumento genera il codice di registrazione che inizializza PCW_COUNTER_DESCRIPTOR le strutture in base al contenuto del manifesto del provider.
Una matrice di PCW_COUNTER_DESCRIPTOR strutture viene fornita durante la registrazione del contatore (tramite la struttura PCW_REGISTRATION_INFORMATION passata a PcwRegister). Le informazioni della matrice vengono registrate e verranno usate PcwCreateInstance da o PcwAddInstance per estrarre i valori dei contatori dai blocchi di dati descritti da una PCW_DATA matrice.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 7 e versioni successive di Windows. |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h) |