DXGKDDI_RECOMMENDFUNCTIONALVIDPN コールバック関数 (d3dkmddi.h)
DxgkDdiRecommend FunctionalVidPn 関数は、指定されたディスプレイ アダプターに実装できる機能 VidPN を作成します。
構文
DXGKDDI_RECOMMENDFUNCTIONALVIDPN DxgkddiRecommendfunctionalvidpn;
NTSTATUS DxgkddiRecommendfunctionalvidpn(
[in] IN_CONST_HANDLE hAdapter,
[in] IN_CONST_PDXGKARG_RECOMMENDFUNCTIONALVIDPN_CONST pRecommendFunctionalVidPn
)
{...}
パラメーター
[in] hAdapter
ディスプレイ アダプターに関連付けられているコンテキスト ブロックへのハンドル。 ディスプレイ ミニポート ドライバーは、以前に DxgkDdiAddDevice 関数のミニポートDeviceContext 出力パラメーターで DirectX グラフィックス カーネル サブシステムにこのハンドルを提供しました。
[in] pRecommendFunctionalVidPn
関数引数を含む DXGKARG_RECOMMENDFUNCTIONALVIDPN 構造体へのポインター。 呼び出し元は、空の VidPN オブジェクトへのハンドルである hRecommendedFunctionalVidPn メンバーを提供します。 DxgkDdiRecommend FunctionalVidPn は、VidPN オブジェクトに、機能する VidPN の要素 (トポロジ、モード セット、固定モード) を設定します。
戻り値
DxgkDdiRecommendFunctionalVidPn は 、次のいずれかの値を返します。
| リターン コード | 説明 |
|---|---|
| STATUS_SUCCESS | 関数は、機能 VidPN の作成に成功しました。 |
| STATUS_GRAPHICS_NO_RECOMMENDED_FUNCTIONAL_VIDPN | 関数は、機能 VidPN を作成できませんでした。 |
| STATUS_NO_MEMORY | メモリを割り当てることができなかったため、関数は失敗しました。 |
注釈
VidPN は、次の条件を満たす場合に機能します。
- 少なくとも 1 つのパスを持つトポロジがあります。 (パスは、ソースとターゲットの間の関連付けです)。
- トポロジ内のすべてのソースとターゲットには固定モードがあります。
- 最初に、空の VidPN オブジェクトへのハンドルを指定します。 このハンドルは、pRecommendFunctionalVidPnArg の hDesiredVidPn メンバーで指定されました。
- VidPN のトポロジにパス (ソースとターゲットのペア) を追加します。
- 新しいソース モード セットを作成し、セットに 1 つのソース モードを追加します。 ソース モード セットをパス内のソースに割り当てます。 ソース モードをピン留めします。
- 新しいターゲット モード セットを作成し、1 つのターゲット モードをセットに追加します。 ターゲット モード セットをパス内のターゲットに割り当てます。 ターゲット モードをピン留めします。
DxgkDdiRecommendFunctionalVidPn を ページング可能にする必要があります。
要件
| サポートされている最小のクライアント | Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |