PCW_MASK_INFORMATION 構造体 (wdm.h)
構造体は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
ビットマスク。 -th ビットが x設定されている場合、ID x を持つカウンターがクエリに含まれます。
InstanceMask
クエリで照合するインスタンス名のワイルドカード指定を含む Unicode 文字列。 すべてのインスタンス名がクエリと一致する必要がある場合、 InstanceMask フィールドは になります "*"。 それ以外の場合は、 "*""?" 通常のワイルドカードの意味がそれぞれ "0 文字以上" と "any-character" になります。 インスタンス名の一致では大文字と小文字は区別されないことに注意してください。
InstanceId
収集するインスタンスの ID を識別する数値。 値が (0xFFFFFFFF) の場合、 PCW_ANY_INSTANCE_ID すべてのインスタンス ID がクエリと一致する必要があります。
CollectMultiple
コンシューマーがクエリの結果で複数のインスタンスを受け入れるかどうかを示す BOOLEAN 値。 カウンターセットが単一インスタンス カウンターセットとして扱われている場合、これは FALSE になります。 カウンターセットがマルチインスタンス カウンターセットとして扱われている場合、これは TRUE になります。
この値は、データ収集を最適化するために使用できます。 が false の場合 CollectMultiple 、コンシューマーによって追加のインスタンスが無視されるため、1 つのインスタンスを追加した後にデータ収集コールバックが返される可能性があります。
Buffer
カウンターセットのインスタンスが追加されるシステムマネージド バッファーへのハンドル。 このハンドルは、 PcwAddInstance を呼び出すとき、または PcwAddInstance の呼び出しをラップする CTRPP によって生成された AddXxx 関数を呼び出すときに使用する必要があります。 詳細については、そのページの「備考」を参照してください。
CancelEvent
このフィールドが NULL 以外の場合、要求が取り消された場合に通知される初期化されたイベント オブジェクトです。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 以降のバージョンの Windows で使用できます。 |
| Header | wdm.h (Wdm.h、Ntddk.h を含む) |