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

こちらもご覧ください

VidPn トポロジ インターフェイス