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 を使用して初期化する必要があります。

要件

こちらもご覧ください

IoWMIDeviceObjectToProviderId

WNODE_EVENT_ITEM

WNODE_HEADER