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