DXGKDDI_VIDPNTOPOLOGY_RELEASEPATHINFO 콜백 함수(d3dkmddi.h)

pfnReleasePathInfo 함수는 VidPN 관리자가 이전에 디스플레이 미니포트 드라이버에 제공한 D3DKMDT_VIDPN_PRESENT_PATH 구조를 해제합니다.

구문

DXGKDDI_VIDPNTOPOLOGY_RELEASEPATHINFO DxgkddiVidpntopologyReleasepathinfo;

NTSTATUS DxgkddiVidpntopologyReleasepathinfo(
  [in] IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
  [in] IN_CONST_PD3DKMDT_VIDPN_PRESENT_PATH_CONST pVidPnPresentPathInfo
)
{...}

매개 변수

[in] hVidPnTopology

VidPN 토폴로지 개체에 대한 핸들입니다. 디스플레이 미니포트 드라이버는 이전에 DXGK_VIDPN_INTERFACE 인터페이스의 pfnGetTopology 함수를 호출하여 이 핸들을 얻었습니다.

[in] pVidPnPresentPathInfo

해제할 D3DKMDT_VIDPN_PRESENT_PATH 구조체에 대한 포인터입니다.

반환 값

pfnReleasePathInfo 함수는 다음 값 중 하나를 반환합니다.

반환 코드	설명
STATUS_SUCCESS	함수가 성공했습니다.
STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY	hVidPnTopology에 제공된 핸들이 잘못되었습니다.
STATUS_GRAPHICS_INVALID_VIDPN_PRESENT_PATH	pVidPnPresentPathInfo에 제공된 포인터가 잘못되었습니다.

설명

다음 함수를 호출하여 얻은 D3DKMDT_VIDPN_PRESENT_PATH 구조체 사용을 완료한 경우 pfnReleasePathInfo를 호출하여 구조를 해제해야 합니다.

• pfnAcquireFirstPathInfo

• pfnAcquireNextPathInfo

• pfnAcqirePathInfo

pfnCreateNewPathInfo를 호출하여 D3DKMDT_VIDPN_PRESENT_PATH 구조를 가져온 다음 해당 구조를 pfnAddPath에 전달하는 경우 구조를 해제할 필요가 없습니다.

pfnCreateNewPathInfo를 호출하여 핸들을 가져온 다음 토폴로지에 새 경로를 추가하지 않기로 결정한 경우 pfnReleasePathInfo를 호출하여 새로 만든 구조체를 해제해야 합니다.

D3DKMDT_HVIDPNTOPOLOGY 데이터 형식은 D3dkmdt.h에 정의되어 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
대상 플랫폼	데스크톱
머리글	d3dkmddi.h(D3dkmddi.h 포함)
IRQL	PASSIVE_LEVEL

추가 정보

D3DKMDT_VIDPN_PRESENT_PATH

pfnAcqirePathInfo

pfnAcquireFirstPathInfo

pfnAcquireNextPathInfo