PFND3DDDI_QUERYDLISTFORAPPLICATION2 コールバック関数 (d3dumddi.h)

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

PFND3DDDI_QUERYDLISTFORAPPLICATION2コールバック関数は、アプリケーションの dList に対してクエリを実行します。

構文

PFND3DDDI_QUERYDLISTFORAPPLICATION2 Pfnd3dddiQuerydlistforapplication2;

HRESULT Pfnd3dddiQuerydlistforapplication2(
  [out] D3DDDI_DLIST_QUERY_RESULT *unnamedParam1,
  [out] D3DDDI_DLIST_QUERY_DECISION_FACTOR *unnamedParam2,
  [in]  HANDLE unnamedParam3,
  [in]  PFND3DDDI_ESCAPECB unnamedParam4
)
{...}

パラメーター

[out] unnamedParam1

クエリ 対象の アプリケーションに対して返される GPU 設定を記述するD3DDDI_DLIST_QUERY_RESULT値へのポインター。

[out] unnamedParam2

返された GPU 設定を決定した要因を記述する D3DDDI_DLIST_QUERY_DECISION_FACTOR 値へのポインター。

[in] unnamedParam3

グラフィックスアダプターオブジェクトへのハンドル。このハンドルは、unnamedParam4 によって指される pfnEscapeCb コールバック関数に渡されます。

[in] unnamedParam4

ディスプレイミニポートドライバーと情報を共有する pfnEscapeCb コールバック関数へのポインター。

戻り値

操作が成功しなかった場合は、S_OKまたは適切なエラー結果を返します。

注釈

WDDM 2.9 以降では、ドライバーはPFND3DDDI_QUERYDLISTFORAPPLICATION1ではなくPFND3DDDI_QUERYDLISTFORAPPLICATION2をサポートする必要があります。

PFND3DDDI_QUERYDLISTFORAPPLICATION2 コールバック関数は、ハイブリッドシステムでの Microsoft Direct3D の初期化中にユーザーモードグラフィックスランタイム (DXGI) によって呼び出され、アプリケーションを実行する GPU を決定します。 dList は、ディスクリート GPU でのハイパフォーマンスレンダリングにクロスアダプター共有サーフェスを必要とするアプリケーションの一覧です。

この DDI で返される D3DDDI_DLIST_QUERY_RESULT と D3DDDI_DLIST_QUERY_DECISION_FACTOR は、更新プログラムのアプリケーション回帰のリスクを評価することで、ランタイムが DxDb コンテンツの更新の品質を確保および向上させるのに役立ちます。

ハイブリッドシステムドライバーでは、この関数をエクスポートする dList DLL を設定して登録する必要があります。ハイブリッドシステムの詳細については、「ハイブリッドシステムでのアダプター間リソースの使用」を参照してください。