PCW_MASK_INFORMATION结构 (wdm.h)

PCW_MASK_INFORMATION 结构是 _PCW_CALLBACK_INFORMATION 联合 EnumerateInstancesCollectData 成员的类型。 它包含系统发送到提供程序定义的 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位,则查询中将包含 ID 为 x 的计数器。

InstanceMask

一个 Unicode 字符串,其中包含要匹配的查询中要匹配的实例名称的通配符规范。 如果所有实例名称都应与查询匹配,InstanceMask 字段将 "*"。 否则,"*""?" 分别具有“零或更多字符”和“any-character”的通配符含义。 请注意,实例名称匹配不区分大小写。

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)

另请参阅

PCW_CALLBACK 回调函数

_PCW_CALLBACK_INFORMATION 结构