структура PCW_MASK_INFORMATION (wdm.h)

Структура PCW_MASK_INFORMATION — это тип EnumerateInstances и CollectData членов союза _PCW_CALLBACK_INFORMATION. Он содержит сведения о уведомлении, отправляемом системой в определяемую поставщиком PCW_CALLBACK функцию.

Синтаксис

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;

Члены

CounterMask

Битовая маска. Если задан x-й бит, счетчик с идентификатором x включен в запрос.

InstanceMask

Строка Юникода, содержащая спецификацию подстановочных знаков имен экземпляров, которые должны быть сопоставлены в запросе. Если все имена экземпляров должны соответствовать запросу, поле InstanceMask будет "*". В противном случае "*" и "?" имеют обычное подстановочное значение "ноль или больше символов" и "любой символ" соответственно. Обратите внимание, что сопоставление имен экземпляра не учитывает регистр.

InstanceId

Числовое значение, определяющее идентификатор собираемых экземпляров. Если значение равно PCW_ANY_INSTANCE_ID (0xFFFFFFFF), все идентификаторы экземпляров должны соответствовать запросу.

CollectMultiple

Значение BOOLEAN, указывающее, принимает ли потребитель несколько экземпляров в результатах запроса. Это значение будет false, если набор счетчиков обрабатывается как набор счетчиков с одним экземпляром. Это значение будет true, если набор счетчиков обрабатывается как набор счетчиков с несколькими экземплярами.

Это значение можно использовать для оптимизации сбора данных. Если CollectMultiple имеет значение false, обратный вызов сбора данных может вернуться после добавления одного экземпляра, так как дополнительные экземпляры будут игнорироваться потребителем.

Buffer

Дескриптор буфера, управляемого системой, в который будут добавлены экземпляры набора счетчиков. Этот дескриптор следует использовать при вызове PcwAddInstance - или при вызове функции AddXxx, созданной CTRPP, которая заключает вызов в PcwAddInstance. Дополнительные сведения см. в примечаниях этой страницы.

CancelEvent

Если это поле не равно NULL, это инициализированный объект события, который будет сигнализировать, если запрос отменен.

Требования

См. также

функции обратного вызова PCW_CALLBACK

_PCW_CALLBACK_INFORMATION структуры