(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，则它是一个初始化的事件对象，在取消请求时将发出信号。

要求

另请参阅

PCW_CALLBACK回调函数

_PCW_CALLBACK_INFORMATION 结构