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 |