struttura PCW_MASK_INFORMATION (wdm.h)
La PCW_MASK_INFORMATION struttura è il tipo dei EnumerateInstances membri e CollectDatadell'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;
Members
CounterMask
Maschera di bit. Se il xbit -th è impostato, 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 InstanceMask campo sarà "*". In caso contrario, "*" e "?" hanno il solito significato jolly di "zero-or-more-characters" e "any-character" rispettivamente. 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ù istanze 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 più istanze.
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 o 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.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 7 e versioni successive di Windows. |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h) |