structure PCW_COUNTER_DESCRIPTOR (wdm.h)
La PCW_COUNTER_DESCRIPTOR
structure est utilisée pour fournir des informations sur une valeur de compteur lors de l’inscription du compteur. La plupart des développeurs n’ont pas besoin d’accéder directement à cette structure, car elle est gérée automatiquement par le code d’inscription du compteur généré par l’outil CTRPP .
typedef struct _PCW_COUNTER_DESCRIPTOR {
USHORT Id;
USHORT StructIndex;
USHORT Offset;
USHORT Size;
} PCW_COUNTER_DESCRIPTOR, *PPCW_COUNTER_DESCRIPTOR;
Id
Valeur numérique qui spécifie l’ID du compteur décrit par cette structure. Cela doit correspondre à la valeur fournie dans le id
champ d’un élément de compteur dans le manifeste de l’ensemble de compteurs 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 StructIndex
champ. Dans les appels suivants à PcwCreateInstance
ou PcwAddInstance
, l’adresse PcwData[PcwCounterDescriptor->StructIndex].Data + PcwCounterDescriptor->Offset
est 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 Size
champ doit avoir la valeur 4 (pour une UINT32
valeur de compteur) ou 8 (pour une UINT64
valeur de compteur).
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 les PCW_COUNTER_DESCRIPTOR
structures en fonction du contenu du manifeste du fournisseur.
Un tableau de structures est fourni lors de l’inscription PCW_COUNTER_DESCRIPTOR
du contre-ensemble (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 PCW_DATA
tableau.
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Disponible dans Windows 7 et versions ultérieures de Windows. |
En-tête | wdm.h (inclure Wdm.h, Ntddk.h) |