(wdm.h) PCW_MASK_INFORMATION 结构
结构PCW_MASK_INFORMATION
是 _PCW_CALLBACK_INFORMATION 联合的 和 CollectData
成员的类型EnumerateInstances
。 它包含系统发送到提供程序定义的 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
如果设置了 -th 位,则具有 ID x
的计数器将包含在查询中。
InstanceMask
一个 Unicode 字符串,其中包含查询中要匹配的实例名称的通配符规范。 如果所有实例名称都应与查询匹配,则 InstanceMask
字段将为 "*"
。 否则, "*"
和 "?"
具有通常的通配符含义分别为“零或多字符”和“任意字符”。 请注意,实例名称匹配不区分大小写。
InstanceId
标识实例的 ID 的数值, (要收集的) 。 如果值为 PCW_ANY_INSTANCE_ID
(0xFFFFFFFF) ,则所有实例 ID 都应与查询匹配。
CollectMultiple
BOOLEAN 值,该值指示使用者是否将在查询结果中接受多个实例。 如果计数器集被视为单实例计数器集,则为 FALSE。 如果计数器集被视为多实例计数器集,则为 TRUE。
此值可用于优化数据收集。 如果 CollectMultiple
为 false,则数据收集回调可以在添加一个实例后返回,因为使用者将忽略其他实例。
Buffer
系统管理的缓冲区的句柄,计数器集的实例 () 将添加到该缓冲区。 调用 PcwAddInstance 时,或调用 CTRPP 生成的 AddXxx 函数(包装对 PcwAddInstance 的调用)时,应使用此句柄。 有关详细信息,请参阅该页的备注。
CancelEvent
如果此字段为非 NULL,则它是一个初始化的事件对象,在取消请求时将发出信号。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 在 Windows 7 和更高版本的 Windows 中可用。 |
标头 | wdm.h (包括 Wdm.h、Ntddk.h) |