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

Vedi anche

PCW_CALLBACK funzione di callback

struttura _PCW_CALLBACK_INFORMATION