PCW_MASK_INFORMATION結構 (wdm.h)
結構PCW_MASK_INFORMATION是_PCW_CALLBACK_INFORMATION等位的 EnumerateInstances 和 CollectData 成員類型。 其中包含由系統傳送給提供者定義 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 位，則會在查詢中包含標識符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) |