DXGKDDI_VIDPNTOPOLOGY_ACQUIREPATHINFO コールバック関数 (d3dkmddi.h)
pfnAcquirePathInfo 関数は、特定の VidPN トポロジ内のビデオ存在ソースとビデオ存在ターゲットによって指定されたビデオの現在のパスの記述子を返します。
構文
DXGKDDI_VIDPNTOPOLOGY_ACQUIREPATHINFO DxgkddiVidpntopologyAcquirepathinfo;
NTSTATUS DxgkddiVidpntopologyAcquirepathinfo(
[in] IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
[out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_PRESENT_PATH ppVidPnPresentPathInfo
)
{...}
パラメーター
[in] hVidPnTopology
VidPN トポロジ オブジェクトへのハンドル。 ディスプレイ ミニポート ドライバーは、DXGK_VIDPN_INTERFACE インターフェイスのpfnGetTopology 関数を呼び出すことによって、このハンドルを以前に取得しました。
[in] VidPnSourceId
ビデオの存在ソースを識別する整数。
[in] VidPnTargetId
ビデオの存在ターゲットを識別する整数。
[out] ppVidPnPresentPathInfo
要求されたパスを記述するD3DKMDT_VIDPN_PRESENT_PATH構造体へのポインターを受け取る変数へのポインター。
戻り値
pfnAcquirePathInfo 関数は、次のいずれかの値を返します。
| リターン コード | 説明 |
|---|---|
| STATUS_SUCCESS | 関数が正常に実行されました。 |
| STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY | hVidPnTopology で指定されたハンドルが無効です。 |
注釈
D3DKMDT_VIDPN_PRESENT_PATH 構造体の使用が完了したら、 pfnReleasePathInfo を呼び出して構造体を解放する必要があります。
パスには (ソース、ターゲット) のペアが含まれており、トポロジはパスのコレクションです。 この関数は、指定した (ソース、ターゲット) ペアを含むパスの記述子を、指定したトポロジで返します。
PfnAcquireFirstPathInfo を呼び出し、pfnAcquireNextPathInfo の一連の呼び出しを行うことで、VidPN トポロジ オブジェクトに属するすべてのパスを列挙できます。
VidPN ソース識別子は、オペレーティング システムによって割り当てられます。 ディスプレイ ミニポート ドライバーによって実装される DxgkDdiStartDevice は、ディスプレイ アダプターでサポートされているビデオの現在のソースの数 N を返します。 次に、オペレーティング システムによって識別子 0、1、2、..が割り当てられます。N - 1。
VidPN ターゲット識別子は、ディスプレイ ミニポート ドライバーによって割り当てられます。 ディスプレイ ミニポート ドライバーによって実装される DxgkDdiQueryChildRelations は、識別子を含むDXGK_CHILD_DESCRIPTOR構造体の配列を返します。
D3DKMDT_HVIDPNTOPOLOGYデータ型は D3dkmdt.h で定義されています。
D3DDDI_VIDEO_PRESENT_SOURCE_IDとD3DDDI_VIDEO_PRESENT_TARGET_IDのデータ型は D3dukmdt.h で定義されています。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| 対象プラットフォーム | デスクトップ |
| Header | d3dkmddi.h (D3dkmddi.h を含む) |
| IRQL | PASSIVE_LEVEL |