DXGKDDI_RECOMMENDVIDPNTOPOLOGY コールバック関数 (d3dkmddi.h)
DxgkDdiRecommendVidPnTopology 関数は、指定された VidPN のトポロジを作成するか、ビデオの現在のターゲットへの新しいパスでトポロジを拡張します。
構文
DXGKDDI_RECOMMENDVIDPNTOPOLOGY DxgkddiRecommendvidpntopology;
NTSTATUS DxgkddiRecommendvidpntopology(
IN_CONST_HANDLE hAdapter,
[in] IN_CONST_PDXGKARG_RECOMMENDVIDPNTOPOLOGY_CONST pRecommendVidPnTopology
)
{...}
パラメーター
hAdapter
ディスプレイ アダプターに関連付けられているコンテキスト ブロックへのハンドル。 ディスプレイ ミニポート ドライバーは、DxgkDdiAddDevice 関数の出力パラメーター ミニポートDeviceContext の 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 |
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |