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