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 |