DXGKDDI_VIDPNTOPOLOGY_ACQUIREPATHINFO 콜백 함수(d3dkmddi.h)

아티클
02/23/2024

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에 정의됩니다.