DXGKDDI_VIDPNTOPOLOGY_GETPATHSOURCEFROMTARGET コールバック関数 (d3dkmddi.h)
pfnGetPathSourceFromTarget 関数は、指定されたビデオ の現在のターゲットに関連付けられているビデオの現在のソースの識別子を返します。
構文
DXGKDDI_VIDPNTOPOLOGY_GETPATHSOURCEFROMTARGET DxgkddiVidpntopologyGetpathsourcefromtarget;
NTSTATUS DxgkddiVidpntopologyGetpathsourcefromtarget(
[in] IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidTopology,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
[out] OUT_PD3DDDI_VIDEO_PRESENT_SOURCE_ID pVidPnSourceId
)
{...}
パラメーター
[in] hVidTopology
VidPN トポロジ オブジェクトへのハンドル。 ディスプレイ ミニポート ドライバーは、DXGK_VIDPN_INTERFACE インターフェイスのpfnGetTopology 関数を呼び出すことによって、以前にこのハンドルを取得しました。
[in] VidPnTargetId
特定のビデオ存在ソースを識別する整数。
[out] pVidPnSourceId
ビデオの現在のソースの識別子を受け取る変数へのポインター。
戻り値
pfnGetPathSourceFromTarget 関数は、次のいずれかの値を返します。
| リターン コード | 説明 |
|---|---|
| STATUS_SUCCESS | 関数が正常に実行されました。 |
| STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY | hVidPnTopology で指定されたハンドルが無効でした。 |
| STATUS_INVALID_PARAMETER | pVidPnSourceId で指定されたポインターが有効でした。 |
注釈
トポロジはコレクション パスであり、それぞれに (ソース、ターゲット) ペアが含まれています。 特定のターゲットは最大 1 つのパスに属しているため、ターゲット ID を指定すると、そのターゲットに関連付けられているソースは最大で 1 つあります。
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 |