DXGKCB_QUERYVIDPNINTERFACE 콜백 함수(d3dkmddi.h)

아티클
08/07/2023

DXGKCB_QUERYVIDPNINTERFACE 디스플레이 미니포트 드라이버가 VidPN 개체를 검사하고 변경하기 위해 호출할 수 있는 함수에 대한 포인터를 포함하는 DXGK_VIDPN_INTERFACE 구조체에 대한 포인터를 가져옵니다.

구문

DXGKCB_QUERYVIDPNINTERFACE DxgkcbQueryvidpninterface;

NTSTATUS DxgkcbQueryvidpninterface(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [in]  IN_CONST_DXGK_VIDPN_INTERFACE_VERSION VidPnInterfaceVersion,
  [out] DEREF_OUT_CONST_PPDXGK_VIDPN_INTERFACE ppVidPnInterface
)
{...}

매개 변수

[in] hVidPn

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

[in] VidPnInterfaceVersion

요청되는 VidPN 인터페이스의 버전을 지정하는 DXGK_VIDPN_INTERFACE_VERSION 열거자입니다. 호출자는 이 매개 변수를 DXGK_VIDPN_INTERFACE_VERSION_V1 설정해야 합니다.

[out] ppVidPnInterface

DXGK_VIDPN_INTERFACE 구조체에 대한 포인터를 수신하는 변수에 대한 포인터입니다.

반환 값

DxgkCbQueryVidPnInterface 는 다음 값 중 하나를 반환합니다.

반환 코드	설명
STATUS_SUCCESS	함수가 성공했습니다.
STATUS_INVALID_PARAMETER	ppVidPnInterface에 전달된 값이 잘못되었습니다.
STATUS_GRAPHICS_INVALID_VIDPN	hVidPn에 전달된 핸들이 잘못되었습니다.
STATUS_NOT_SUPPORTED	VidPnInterfaceVersion에서 지정한 인터페이스 버전은 지원되지 않습니다.

설명

DXGKCB_XXX 함수는 Dxgkrnl에 의해 구현됩니다. 이 콜백 함수를 사용하기 위해 커널 모드 드라이버는 DXGKRNL_INTERFACE 통해 DxgkCbQueryVidPnInterface를 호출합니다.

요구 사항

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