DXGKARG_QUERYFEATUREINTERFACE構造体 (d3dkmddi.h)

[アーティクル]
05/23/2024

DXGKARG_QUERYFEATUREINTERFACE は、 DxgkDdiQueryFeatureInterface 関数のパラメーターです。

構文

typedef struct _DXGKARG_QUERYFEATUREINTERFACE {
  DXGK_FEATURE_ID      FeatureId;
  DXGK_FEATURE_VERSION Version;
  UINT16               InterfaceSize;
  void                 *Interface;
} DXGKARG_QUERYFEATUREINTERFACE;

メンバー

FeatureId

[入力]インターフェイスのクエリを実行する機能の ID を指定するDXGK_FEATURE_ID列挙値。

Version

[入力]インターフェイスのクエリが実行されている機能のバージョン。「解説」を参照してください。

InterfaceSize

[入力/出力] Interface が指すインターフェイスバッファーのサイズ (バイト単位)。成功した場合、この値は返されるインターフェイスのサイズに設定する必要があります。出力値が要求されたインターフェイスの入力サイズより小さい場合、呼び出し元は STATUS_BUFFER_TOO_SMALL などのエラーを返す必要があります。

Interface

[入力/出力]入力するインターフェイスバッファーへのポインター。このバッファーは、正確に InterfaceSize バイトの長さであることが保証されます。

注釈

機能インターフェイスは、同じインターフェイスの古いバージョンと下位互換性を持つ必要はありません。たとえば、機能のバージョン 1 とバージョン 2 のインターフェイスが大きく異なる場合があります (つまり、v2 インターフェイスは v1 インターフェイスの拡張機能である必要はありません)。これは、DDI を永続的にサポートする必要なく、機能の設計が時間の経過と同時に反復処理される場合に機能を引き出す場合に役立ちます。

特定のバージョンの機能のインターフェイスはドキュメント内のどこかで永久に定義される場合もありますが、OS とドライバーは、サポートされる機能の下限 (最小) バージョンを設定して、古い非推奨のインターフェイスをサポートする必要性を減らすことができます。

詳細については、「 WDDM 機能のサポートと有効化のクエリ」を参照してください。