QUERY_INTERFACE構造 (video.h)

QUERY_INTERFACE 構造体は、要求されるインターフェイスを記述します。

構文

typedef struct _QUERY_INTERFACE {
  const GUID *InterfaceType;
  USHORT     Size;
  USHORT     Version;
  PINTERFACE Interface;
  PVOID      InterfaceSpecificData;
  ULONG      DeviceUid;
} QUERY_INTERFACE, *PQUERY_INTERFACE;

メンバーズ

InterfaceType

要求されているインターフェイスを識別する GUID へのポインター。 カーネル モード ディスプレイ ミニポート ドライバー (KMD) (または従来のビデオ ミニポート ドライバー) が、指定された InterfaceTypeをサポートしていない場合は、呼び出しに失敗し、すぐに戻る必要があります。

親は、uuidgen.exeを使用してこの GUID を生成します。 詳細については、「新しい GUID の定義とエクスポート」を参照してください。

Size

インターフェイスがポイントする INTERFACE 構造体のサイズ (バイト単位) を指定します。 ドライバーは、サイズ バイト より大きい構造体 インターフェイスを返す必要があります。

Version

要求されるインターフェイスのバージョンを指定します。

親が複数のバージョンのインターフェイスをサポートしている場合、ドライバーは、指定されたバージョンを返す必要があります。可能であれば、要求されたバージョンを超えることなく、サポートされている最も近いバージョンを返す必要があります。 呼び出し元は、返された バージョンの を調べて、その値に基づいて何を行うかを決定する必要があります。

Interface

ドライバーが要求されたインターフェイス情報を返す 構造体を インターフェイスへのポインター。 呼び出し元は、DxgkddiQueryInterface (または HwVidQueryInterface) 呼び出す前に、この構造体を割り当てる必要があります。

InterfaceSpecificData

要求されるインターフェイスに関する追加情報を指定します。 通常、このメンバーは NULL であり、InterfaceType メンバーと Version メンバーは、要求されているインターフェイスを親が識別するのに十分です。

DeviceUid

インターフェイスが照会されるデバイスを識別する正の整数。 DeviceUid が DISPLAY_ADAPTER_HW_ID (Video.hで定義) と等しい場合、デバイスはディスプレイ アダプター自体です。 それ以外の場合、DeviceUid は、ディスプレイ アダプターの子デバイスの識別子です。 子デバイス識別子は、DxgkDdiQueryChildRelations 関数によって以前に割り当てられました。 Windows 8.1 (WDDM 1.3) 以降で使用できます。

備考

KMD の DxgkddiQueryInterface コールバックの QueryInterface パラメーター (または 's HwVidQueryInterface 関数レガシ ビデオ ミニポート ドライバー ) は、QUERY_INTERFACE 構造体へのポインターです。

必要条件

要件	価値
ヘッダー	video.h (Video.h を含む)

関連項目

DxgkddiQueryInterface の

HwVidQueryInterface の