estrutura PCW_MASK_INFORMATION (wdm.h)

A estrutura PCW_MASK_INFORMATION é o tipo dos membros EnumerateInstances e CollectData do sindicato _PCW_CALLBACK_INFORMATION. Ele contém detalhes de uma notificação enviada pelo sistema para uma função de PCW_CALLBACK definida pelo provedor.

Sintaxe

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;

Membros

CounterMask

Uma máscara de bits. Se o x-th bit estiver definido, o contador com x de ID será incluído na consulta.

InstanceMask

Uma cadeia de caracteres Unicode que contém uma especificação curinga de nomes de instância a serem correspondidos na consulta. Se todos os nomes de instância corresponderem à consulta, o campo InstanceMask será "*". Caso contrário, "*" e "?" têm o significado curinga habitual de "zero ou mais caracteres" e "qualquer caractere", respectivamente. Observe que a correspondência de nomes de instância não diferencia maiúsculas de minúsculas.

InstanceId

O valor numérico que identifica a ID das instâncias a serem coletadas. Se o valor for PCW_ANY_INSTANCE_ID (0xFFFFFFFF), todas as IDs de instância deverão corresponder à consulta.

CollectMultiple

O valor BOOLEAN que indica se o consumidor aceitará mais de uma instância nos resultados da consulta. Isso será FALSE se o contador estiver sendo tratado como um contraconjunto de instância única. Isso será TRUE se o contraconjunto estiver sendo tratado como um contraconjunto de várias instâncias.

Esse valor pode ser usado para otimizar a coleta de dados. Se CollectMultiple for falso, o retorno de chamada da coleta de dados poderá retornar depois de adicionar uma instância, pois instâncias adicionais serão ignoradas pelo consumidor.

Buffer

Um identificador para o buffer gerenciado pelo sistema ao qual as instâncias do contador serão adicionadas. Esse identificador deve ser usado ao chamar PcwAddInstance – ou ao chamar a função AddXxx gerada por CTRPP, que encapsula a chamada para PcwAddInstance. Para obter mais informações, consulte os Comentários dessa página.

CancelEvent

Se esse campo não for NULL, será um objeto de evento inicializado que será sinalizado se a solicitação for cancelada.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível no Windows 7 e versões posteriores do Windows.
cabeçalho	wdm.h (include Wdm.h, Ntddk.h)

Consulte também

PCW_CALLBACK função de retorno de chamada

estrutura _PCW_CALLBACK_INFORMATION