DXGKDDI_VIDPNTOPOLOGY_ADDPATH コールバック関数 (d3dkmddi.h)

pfnAddPath 関数は、指定された VidPN トポロジ オブジェクトにビデオの存在パスを追加します。

構文

DXGKDDI_VIDPNTOPOLOGY_ADDPATH DxgkddiVidpntopologyAddpath;

NTSTATUS DxgkddiVidpntopologyAddpath(
  [in] IN_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
  [in] IN_PD3DKMDT_VIDPN_PRESENT_PATH pVidPnPresentPath
)
{...}

パラメーター

[in] hVidPnTopology

VidPN トポロジ オブジェクトへのハンドル。 ディスプレイ ミニポート ドライバーは、DXGK_VIDPN_INTERFACE インターフェイスの pfnGetTopology 関数を呼び出すことによって、このハンドルを取得しました。

[in] pVidPnPresentPath

パスを記述するD3DKMDT_VIDPN_PRESENT_PATH構造体へのポインター。 ディスプレイ ミニポート ドライバーは、pfnCreateNewPathInfo 呼び出すことによって、このポインターを以前に取得しました。

戻り値

pfnAddPath 関数は、次のいずれかの値を返します。

リターン コード	形容
STATUS_SUCCESS	関数は成功しました。
STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY	hVidPnTopology で指定されたハンドルが無効でした。
STATUS_ACCESS_DENIED	パスは、現在の DDI 呼び出しのコンテキストでは削除できません。

備考

トポロジへのパスを追加するには、ディスプレイ ミニポート ドライバーは、次の手順を実行します。

pfnCreateNewPathInfo 呼び出して、VidPN マネージャーによって割り当てられた D3DKMDT_VIDPN_PRESENT_PATH 構造体へのポインターを取得します。

D3DKMDT_VIDPN_PRESENT_PATH構造にパスに関する情報 (ビデオの存在するソース識別子やターゲット識別子など) を設定します。

pfnAddPath 呼び出して、トポロジへのパスを追加します。

pfnCreateNewPathInfo 呼び出すと、VidPN マネージャーはD3DKMDT_VIDPN_PRESENT_PATH構造体を割り当てます。 その構造によって記述されたパスをトポロジに追加する場合、その構造を明示的に解放する必要はありません。pfnAddPath を解放。

pfnCreateNewPathInfo 呼び出してD3DKMDT_VIDPN_PRESENT_PATH構造体を取得し、そのパスをトポロジに追加しない場合は、pfnReleasePathInfo 呼び出して構造体を明示的に解放する必要があります。

D3DKMDT_HVIDPNTOPOLOGY データ型は、 D3dkmdt.hで定義されます。

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista
ターゲット プラットフォーム の	デスクトップ
ヘッダー	d3dkmddi.h (D3dkmddi.h を含む)
IRQL	PASSIVE_LEVEL

関連項目

D3DKMDT_VIDPN_PRESENT_PATH

pfnCreateNewPathInfo を する

pfnReleasePathInfo を する