DXGKDDI_VIDPN_GETTOPOLOGY 콜백 함수(d3dkmddi.h)

  • 아티클

pfnGetTopology 함수는 지정된 VidPN 개체에 포함된 VidPN 토폴로지 개체에 대한 핸들을 반환합니다.

구문

DXGKDDI_VIDPN_GETTOPOLOGY DxgkddiVidpnGettopology;

NTSTATUS DxgkddiVidpnGettopology(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [out] OUT_PD3DKMDT_HVIDPNTOPOLOGY phVidPnTopology,
  [out] DEREF_OUT_CONST_PPDXGK_VIDPNTOPOLOGY_INTERFACE ppVidPnTopologyInterface
)
{...}

매개 변수

[in] hVidPn

VidPN 개체에 대한 핸들입니다. VidPN 관리자는 이전에 DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn 또는 DxgkDdiRecommendFunctionalVidPn을 호출하여 디스플레이 미니포트 드라이버에 이 핸들을 제공했습니다.

[out] phVidPnTopology

VidPN 토폴로지 개체에 대한 핸들을 수신하는 변수에 대한 포인터입니다.

[out] ppVidPnTopologyInterface

DXGK_VIDPNTOPOLOGY_INTERFACE 구조체에 대한 포인터를 수신하는 변수에 대한 포인터입니다. 구조체에는 디스플레이 미니포트 드라이버가 VidPN 토폴로지 개체를 검사하고 변경하기 위해 호출할 수 있는 함수에 대한 포인터가 포함되어 있습니다.

반환 값

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

반환 코드 설명
STATUS_SUCCESS 함수가 성공했습니다.
STATUS_GRAPHICS_INVALID_VIDPN hVidPn에 제공된 핸들이 잘못되었습니다.

설명

디스플레이 미니포트 드라이버는 phVidPnTopology에서 수신하는 핸들을 해제할 필요가 없습니다.

ppVidPnTopologyInterface에서 반환된 DXGK_VIDPNTOPOLOGY_INTERFACE 구조체의 수명은 운영 체제에서 소유합니다. 이 소유권 체계를 사용하여 운영 체제는 인터페이스의 클라이언트를 중단하지 않고 런타임에 최신 구현으로 마이그레이션할 수 있습니다.

요구 사항

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

추가 정보

DXGK_VIDPNTOPOLOGY_INTERFACE

VidPN 토폴로지 인터페이스