共用方式為


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位,則查詢中會包含標識符為 x 的計數器。

InstanceMask

Unicode 字串,其中包含查詢中要比對之實例名稱的通配符規格。 如果所有實體名稱都應該符合查詢,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)

另請參閱

PCW_CALLBACK 回呼函式

_PCW_CALLBACK_INFORMATION 結構