DXGKDDI_VIDPNTOPOLOGY_ENUMPATHTARGETSFROMSOURCE コールバック関数 (d3dkmddi.h)

pfnEnumPathTargetsFromSource 関数は、指定されたビデオ 存在ソースに関連付けられているビデオの存在ターゲットの 1 つの識別子を返します。

構文

DXGKDDI_VIDPNTOPOLOGY_ENUMPATHTARGETSFROMSOURCE DxgkddiVidpntopologyEnumpathtargetsfromsource;

NTSTATUS DxgkddiVidpntopologyEnumpathtargetsfromsource(
  [in]  IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
  [in]  IN_CONST_D3DKMDT_VIDPN_PRESENT_PATH_INDEX VidPnPresentPathIndex,
  [out] OUT_PD3DDDI_VIDEO_PRESENT_TARGET_ID pVidPnTargetId
)
{...}

パラメーター

[in] hVidPnTopology

VidPN トポロジ オブジェクトへのハンドル。 ディスプレイ ミニポート ドライバーは、DXGK_VIDPN_INTERFACE インターフェイスの pfnGetTopology 関数を呼び出すことによって、このハンドルを取得しました。

[in] VidPnSourceId

特定のビデオ存在ソースを識別する整数。

[in] VidPnPresentPathIndex

VidPnSourceId によって識別されるソースを含むパスのセット0 から始まるインデックス。

[out] pVidPnTargetId

ターゲット識別子を受け取る変数へのポインター。

戻り値

pfnEnumPathTargetsFromSource 関数は、次のいずれかの値を返します。

リターン コード	形容
STATUS_SUCCESS	関数は成功しました。
STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY	hVidPnTopology で指定されたハンドルが無効でした。
STATUS_INVALID_PARAMETER	pVidPnTargetId で指定されたポインターが有効でした。

備考

VidPnPresentPathIndex は、hVidPnTopology によって識別されるトポロジ内のすべてのパスのセットインデックスではありません。 これは、トポロジ内のすべてのパスのサブセットへのインデックスです。具体的には、VidPnSourceId によって識別されるソース含むすべてのパスのサブセットです。

特定のソースに関連付けられているすべてのターゲットを (特定のトポロジ内で) 列挙するには、次の手順を実行します。

pfnGetNumPathsFromSource 呼び出して、対象のソースを含むパスの数 N を決定します。 これらのパスは、インデックス 0、1、..を持つインデックス付きセットと考えてください。N - 1。

N ~ 1 のインデックス 0 ごとに、ソース識別子とインデックスを pfnEnumPathTargetsFromSource 渡します。

トポロジはコレクション パスであり、それぞれに (ソース、ターゲット) のペアが含まれています。 特定のソースが複数のパスに表示される可能性があります。 たとえば、複製ビューの場合、1 つのソースを 2 つの異なるターゲットとペアにすることができます。

VidPN ソース識別子は、オペレーティング システムによって割り当てられます。 DxgkDdiStartDevice 、ディスプレイ ミニポート ドライバーによって実装され、ディスプレイ アダプターでサポートされているビデオの現在のソースの数 N を返します。 次に、オペレーティング システムによって識別子 0、1、2、..が割り当てられます。N - 1。

VidPN ターゲット識別子は、ディスプレイ ミニポート ドライバーによって割り当てられます。 DxgkDdiQueryChildRelationsは、ディスプレイ ミニポート ドライバーによって実装され、識別子を含む DXGK_CHILD_DESCRIPTOR 構造体の配列を返します。

D3DKMDT_HVIDPNTOPOLOGYとD3DKMDT_VIDPN_PRESENT_PATH_INDEXのデータ型は、D3dkmdt.hで定義されます。

D3DDDI_VIDEO_PRESENT_SOURCE_IDとD3DDDI_VIDEO_PRESENT_TARGET_IDのデータ型は、D3dukmdt.hで定義されます。

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista
ターゲット プラットフォーム の	デスクトップ
ヘッダー	d3dkmddi.h (D3dkmddi.h を含む)
IRQL	PASSIVE_LEVEL

関連項目

pfnGetNumPathsFromSource を する

pfnGetPathSourceFromTarget を する