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
対象プラットフォーム	デスクトップ
Header	d3dkmddi.h (D3dkmddi.h を含む)
IRQL	PASSIVE_LEVEL

こちらもご覧ください

D3DKMDT_VIDPN_PRESENT_PATH

pfnCreateNewPathInfo

pfnReleasePathInfo