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
ターゲット プラットフォーム の	デスクトップ
ヘッダー	d3dkmddi.h (D3dkmddi.h を含む)
IRQL	PASSIVE_LEVEL

関連項目

pfnEnumPathTargetsFromSource を する