DXGKDDI_RECOMMENDVIDPNTOPOLOGY コールバック関数 (d3dkmddi.h)
DxgkDdiRecommendVidPnTopology 関数は、指定された VidPN のトポロジを作成するか、ビデオの現在のターゲットへの新しいパスを使用してトポロジを拡張します。
構文
DXGKDDI_RECOMMENDVIDPNTOPOLOGY DxgkddiRecommendvidpntopology;
NTSTATUS DxgkddiRecommendvidpntopology(
IN_CONST_HANDLE hAdapter,
[in] IN_CONST_PDXGKARG_RECOMMENDVIDPNTOPOLOGY_CONST pRecommendVidPnTopology
)
{...}
パラメーター
hAdapter
ディスプレイ アダプターに関連付けられているコンテキスト ブロックへのハンドル。 ディスプレイ ミニポート ドライバーは、以前、DxgkDdiAddDevice 関数の MiniportDeviceContext 出力パラメーターで Microsoft DirectX グラフィックス カーネル サブシステムにこのハンドルを提供しました。
[in] pRecommendVidPnTopology
関数引数を含む DXGKARG_RECOMMENDVIDPNTOPOLOGY 構造体へのポインター。
戻り値
DxgkDdiRecommendVidPnTopology は、次のいずれかの値を返します。
| リターン コード | 説明 |
|---|---|
| STATUS_SUCCESS | 関数によってトポロジが正常に作成または拡張されました。 |
| STATUS_GRAPHICS_NO_RECOMMENDED_VIDPN_TOPOLOGY | 関数には、指定された VidPN トポロジの拡張に関する推奨事項はありません。 |
| STATUS_GRAPHICS_CANCEL_VIDPN_TOPOLOGY_AUGMENTATION | 関数では、指定したソースで指定された VidPN のトポロジの拡張をキャンセルすることをお勧めします。 このリターン コードは、VidPN トポロジ拡張の場合にのみ許可されます。 |
| STATUS_NO_MEMORY | 十分なメモリを割り当てられなかったため、関数は失敗しました。 |
ミニポート ドライバーは、フォールバック コード パスがないオペレーティング システムから取得したエラー コードを通過する必要があります。
注釈
DxgkDdiRecommendVidPnTopology をページング可能にする必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| 対象プラットフォーム | デスクトップ |
| Header | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |