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
位,則查詢中會包含標識符為 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) |