structure PCW_COUNTER_DESCRIPTOR (wdm.h)

  • Article

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 .

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 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).

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 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.

Configuration requise

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)

Voir aussi

structure _PCW_REGISTRATION_INFORMATION

structure _PCW_DATA

CTRPP

type complexe de compteur