structure PCW_COUNTER_DESCRIPTOR (wdm.h)
La structure PCW_COUNTER_DESCRIPTOR est utilisée pour fournir des informations sur une valeur de compteur pendant l’inscription du compteur. La plupart des développeurs n’ont pas besoin d’accéder directement à cette structure, car elle est automatiquement gérée par le code d’inscription du compteur généré par l’outil CTRPP.
Syntaxe
typedef struct _PCW_COUNTER_DESCRIPTOR {
USHORT Id;
USHORT StructIndex;
USHORT Offset;
USHORT Size;
} PCW_COUNTER_DESCRIPTOR, *PPCW_COUNTER_DESCRIPTOR;
Membres
Id
Valeur numérique qui spécifie l’ID du compteur décrit par cette structure. Cela doit correspondre à la valeur fournie dans le champ id d’un compteur élément dans le manifeste du compteur du fournisseur.
StructIndex
Valeur numérique qui spécifie un index dans un tableau de structures PCW_DATA. Dans les appels suivants à PcwCreateInstance ou PcwAddInstance, le bloc de données décrit par PcwData[PcwCounterDescriptor->StructIndex] sera utilisé comme source de données pour le compteur avec l’ID PcwCounterDescriptor->Id.
Offset
Valeur numérique qui spécifie un décalage (en octets) par rapport au bloc de données indiqué par le champ StructIndex. Dans les appels suivants à PcwCreateInstance ou PcwAddInstance, l’adresse PcwData[PcwCounterDescriptor->StructIndex].Data + PcwCounterDescriptor->Offset sera utilisée comme début de la valeur du compteur avec l’ID PcwCounterDescriptor->Id.
Size
Valeur numérique qui spécifie la taille, en octets, de la valeur du compteur avec l’ID PcwCounterDescriptor->Id. Le champ Size doit être défini sur 4 (pour une valeur de compteur UINT32) ou 8 (pour une valeur de compteur UINT64).
Remarques
La plupart des développeurs n’ont pas besoin d’utiliser cette structure directement. L’outil CTRPP génère du code d’inscription qui initialise PCW_COUNTER_DESCRIPTOR structures en fonction du contenu du manifeste du fournisseur.
Un tableau de structures PCW_COUNTER_DESCRIPTOR est fourni lors de l’inscription du compteur (via la structure PCW_REGISTRATION_INFORMATION passée à PcwRegister). Les informations du tableau sont enregistrées et seront utilisées par PcwCreateInstance ou PcwAddInstance pour extraire des valeurs de compteur des blocs de données décrits par un tableau PCW_DATA.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows 7 et versions ultérieures de Windows. |
| d’en-tête | wdm.h (include Wdm.h, Ntddk.h) |