struttura PCW_MASK_INFORMATION (wdm.h)
La struttura PCW_MASK_INFORMATION è il tipo di EnumerateInstances e CollectData membri dell'unione _PCW_CALLBACK_INFORMATION. Contiene i dettagli di una notifica inviata dal sistema a una funzione di PCW_CALLBACK definita dal provider.
Sintassi
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;
Membri
CounterMask
Maschera di bit. Se la x-th bit è impostata, il contatore con ID x viene incluso nella query.
InstanceMask
Stringa Unicode che contiene una specifica con caratteri jolly dei nomi di istanza da trovare nella query. Se tutti i nomi di istanza devono corrispondere alla query, il campo InstanceMask verrà "*". In caso contrario, "*" e "?" hanno rispettivamente il significato di "zero o più caratteri" e "any-character". Si noti che la corrispondenza dei nomi dell'istanza non fa distinzione tra maiuscole e minuscole.
InstanceId
Valore numerico che identifica l'ID delle istanze da raccogliere. Se il valore è PCW_ANY_INSTANCE_ID (0xFFFFFFFF), tutti gli ID istanza devono corrispondere alla query.
CollectMultiple
Valore BOOLEAN che indica se il consumer accetterà più di un'istanza nei risultati della query. Questo valore sarà FALSE se il contatore viene considerato come un contatore a istanza singola. Questo valore sarà TRUE se il contatore viene considerato come un contatore a istanze multipla.
Questo valore può essere usato per ottimizzare la raccolta dati. Se CollectMultiple è false, il callback della raccolta dati può restituire dopo l'aggiunta di un'istanza perché le istanze aggiuntive verranno ignorate dal consumer.
Buffer
Handle per il buffer gestito dal sistema in cui verranno aggiunte le istanze del contatore. Questo handle deve essere usato quando si chiama PcwAddInstance oppure quando si chiama la funzione AddXxx generata da CTRPP, che esegue il wrapping della chiamata a PcwAddInstance. Per altre info, vedi la sezione Osservazioni di tale pagina.
CancelEvent
Se questo campo non è NULL, si tratta di un oggetto evento inizializzato che verrà segnalato se la richiesta viene annullata.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Windows 7 e versioni successive di Windows. |
| intestazione | wdm.h (include Wdm.h, Ntddk.h) |