DXGKDDI_MONITOR_GETADDITIONALMONITORMODESET 콜백 함수(d3dkmddi.h)

아티클
06/10/2023

pfnGetAdditionalMonitorModeSet 함수는 지정된 모니터와 연결된 추가 모니터 소스 모드 집합 개체에 대한 핸들을 반환합니다. Windows 7부터 DXGK_MONITOR_INTERFACE_V2 인터페이스에서 사용할 수 있습니다.

구문

DXGKDDI_MONITOR_GETADDITIONALMONITORMODESET DxgkddiMonitorGetadditionalmonitormodeset;

NTSTATUS DxgkddiMonitorGetadditionalmonitormodeset(
  [in]  IN_CONST_D3DKMDT_ADAPTER hAdapter,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
  [out] OUT_PUINT pNumberModes,
  [out] DEREF_ECOUNT_PPDXGK_TARGETMODE_DETAIL_TIMING ppAdditionalModesSet
)
{...}

매개 변수

[in] hAdapter

디스플레이 어댑터를 식별하는 핸들입니다. Microsoft DirectX 그래픽 커널 하위 시스템은 이전에 DxgkDdiStartDevice 함수의 DxgkInterface 매개 변수에 있는 디스플레이 미니포트 드라이버에 이 핸들을 제공했습니다.

[in] VideoPresentTargetId

디스플레이 어댑터에 있는 비디오 대상 중 하나를 식별하는 정수입니다. 반환 된 ppAdditionalModesSet 추가 모드 집합 개체는 이 비디오 현재 대상에 연결된 모니터에서 사용할 수 있는 추가 모니터 소스 모드 집합을 설명합니다.

[out] pNumberModes

VideoPresentTargetId로 지정된 비디오 현재 대상의 추가 타이밍 모드 수를 포함하는 변수에 대한 포인터입니다.

[out] ppAdditionalModesSet

DXGK_TARGETMODE_DETAIL_TIMING 구조체에 대한 포인터를 수신하는 변수에 대한 포인터입니다. 구조체는 디스플레이 디바이스와 호환되는 비디오 제공 대상의 추가 타이밍 모드를 설명합니다.

반환 값

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

반환 코드	설명
STATUS_SUCCESS	함수가 성공했습니다.
STATUS_GRAPHICS_INVALID_DISPLAY_ADAPTER	hAdapter에 제공된 핸들이 잘못되었습니다.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET	VideoPresentTargetId에 제공된 식별자가 잘못되었습니다.
STATUS_GRAPHICS_MONITOR_NOT_CONNECTED	VideoPresentTargetId로 식별된 비디오 현재 대상에 연결된 모니터가 없습니다.
STATUS_NOT_FOUND	VideoPresentTargetId로 식별된 비디오 현재 대상을 찾을 수 없습니다.

설명

VidPN 대상 식별자는 디스플레이 미니포트 드라이버에 의해 할당됩니다. 디스플레이 미니포트 드라이버에 의해 구현된 DxgkDdiQueryChildRelations 함수는 각각 식별자가 포함된 DXGK_CHILD_DESCRIPTOR 구조의 배열을 반환합니다.

이 함수는 Windows 7부터 사용할 수 있습니다.