структура 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 или при вызове созданной CTRPP функции AddXxx, которая создает оболочку для вызова PcwAddInstance. Дополнительные сведения см. в разделе Примечания этой страницы.
CancelEvent
Если это поле не равно NULL, это инициализированный объект события, который будет сигнализироваться при отмене запроса.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Windows 7 и более поздних версиях Windows. |
| Верхняя часть | wdm.h (включая Wdm.h, Ntddk.h) |