structure PCW_MASK_INFORMATION (wdm.h)

La PCW_MASK_INFORMATION structure est le type des EnumerateInstances membres et CollectData de l’union _PCW_CALLBACK_INFORMATION . Il contient les détails d’une notification envoyée par le système à une fonction PCW_CALLBACK définie par le fournisseur.

Syntaxe

typedef struct _PCW_MASK_INFORMATION {
  ULONG64          CounterMask;
  PCUNICODE_STRING InstanceMask;
  ULONG            InstanceId;
  BOOLEAN          CollectMultiple;
  PPCW_BUFFER      Buffer;
  PKEVENT          CancelEvent;
} PCW_MASK_INFORMATION, *PPCW_MASK_INFORMATION;

Membres

CounterMask

Un masque de bits. Si le x-th bit est défini, le compteur avec l’ID x est inclus dans la requête.

InstanceMask

Chaîne Unicode qui contient une spécification générique de noms instance à mettre en correspondance dans la requête. Si tous les noms instance doivent correspondre à la requête, le InstanceMask champ est "*". Sinon, "*" et "?" ont la signification générique habituelle de « zéro ou plus caractères » et « tout caractère » respectivement. Notez que instance correspondance de nom ne respecte pas la casse.

InstanceId

Valeur numérique qui identifie l’ID des instance à collecter. Si la valeur est PCW_ANY_INSTANCE_ID (0xFFFFFFFF), tous les ID instance doivent correspondre à la requête.

CollectMultiple

Valeur BOOLEAN qui indique si le consommateur acceptera plusieurs instance dans les résultats de la requête. Cette valeur est FALSE si le compteur est traité comme un contre-ensemble à instance unique. Cette valeur est TRUE si le compteur est traité comme un contre-ensemble multi-instance.

Cette valeur peut être utilisée pour optimiser la collecte de données. Si CollectMultiple est false, le rappel de collecte de données peut retourner après l’ajout d’une instance, car les instances supplémentaires seront ignorées par le consommateur.

Buffer

Handle à la mémoire tampon gérée par le système à laquelle les instance du compteur seront ajoutés. Ce handle doit être utilisé lors de l’appel de PcwAddInstance ou lors de l’appel de la fonction AddXxx générée par CTRPP, qui encapsule l’appel à PcwAddInstance. Pour plus d’informations, consultez les remarques de cette page.

CancelEvent

Si ce champ n’est pas NULL, il s’agit d’un objet d’événement initialisé qui sera signalé si la demande est annulée.

Configuration requise

Voir aussi

PCW_CALLBACK fonction de rappel

structure _PCW_CALLBACK_INFORMATION