WNODE_EVENT_REFERENCE 構造体 (wmistr.h)
WNODE_EVENT_REFERENCE構造体には、WMI がレジストリで設定されているイベント サイズ制限を超えるイベントのクエリに使用できる情報が含まれています。
構文
typedef struct tagWNODE_EVENT_REFERENCE {
struct _WNODE_HEADER WnodeHeader;
GUID TargetGuid;
ULONG TargetDataBlockSize;
union {
ULONG TargetInstanceIndex;
WCHAR TargetInstanceName[];
} DUMMYUNIONNAME;
} WNODE_EVENT_REFERENCE, *PWNODE_EVENT_REFERENCE;
メンバー
WnodeHeader
バッファー サイズ、プロバイダー ID、要求に関連付けられたデータ ブロックを表す GUID、渡されるまたは返されるWNODE_XXX データに関する情報を提供するフラグなど、すべてのWNODE_XXX 構造体に共通する情報を含むWNODE_HEADER構造体です。
TargetGuid
クエリを実行するイベントを表す GUID を示します。
TargetDataBlockSize
イベントのサイズを示します。
DUMMYUNIONNAME
DUMMYUNIONNAME.TargetInstanceIndex
イベントの静的インスタンス名のドライバーの一覧へのインデックスを示します。 このメンバーは、イベント ブロックが静的インスタンス名で登録され、WNODE_FLAGS_STATIC_INSTANCE_NAMES が WnodeHeader.Flags に設定されている場合にのみ有効です。
DUMMYUNIONNAME.TargetInstanceName
イベントの動的インスタンス名を、カウントされた Unicode 文字列として示します。 このメンバーは、 WnodeHeader.Flags でWNODE_FLAGS_STATIC_INSTANCE_NAMESがクリアされ、イベント ブロックが動的インスタンス名で登録されている場合にのみ有効です。
注釈
イベントのデータ量がレジストリに設定されている最大サイズを超えた場合、ドライバーは WMI がイベントを取得するためにクエリを実行できる WNODE_EVENT_ITEM を指定する WNODE_EVENT_REFERENCE を生成できます。 WMI イベントの定義と生成の詳細については、「WMI の 実装」を参照してください。
WNODE_EVENT_REFERENCE構造体で使用するWNODE_HEADER構造体のProviderId メンバーは、IoWMIDeviceObjectToProviderId を使用して初期化する必要があります。
要件
| 要件 | 値 |
|---|---|
| Header | wmistr.h (Wmistr.h を含む) |