다음을 통해 공유

DXGKDDI_MONITORSOURCEMODESET_ACQUIREPREFERREDMODEINFO 콜백 함수(d3dkmddi.h)

  • 아티클

pfnAcquirePreferredModeInfo는 지정된 모니터 소스 모드 집합 개체에서 기본 모드의 설명자를 반환합니다.

구문

DXGKDDI_MONITORSOURCEMODESET_ACQUIREPREFERREDMODEINFO DxgkddiMonitorsourcemodesetAcquirepreferredmodeinfo;

NTSTATUS DxgkddiMonitorsourcemodesetAcquirepreferredmodeinfo(
  [in]  IN_CONST_D3DKMDT_HMONITORSOURCEMODESET hMonitorSourceModeSet,
  [out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_SOURCE_MODE ppFirstMonitorSourceModeInfo
)
{...}

매개 변수

[in] hMonitorSourceModeSet

모니터 소스 모드 집합 개체에 대한 핸들입니다. 디스플레이 미니포트 드라이버는 이전에 모니터 인터페이스의 pfnAcquireMonitorSourceModeSet 함수를 호출하여 이 핸들을 얻었습니다.

[out] ppFirstMonitorSourceModeInfo

D3DKMDT_MONITOR_SOURCE_MODE 구조체에 대한 포인터를 수신하는 변수에 대한 포인터입니다. 구조체에는 ID 및 비디오 신호를 포함하여 기본 모니터 소스 모드에 대한 다양한 정보가 포함되어 있습니다.

반환 값

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

반환 코드 설명
STATUS_SUCCESS 함수는 기본 설정 모드의 설명자를 성공적으로 반환했습니다.
STATIS_GRAPHICS_NO_PREFERRED_MODE 함수가 성공했지만 지정된 모니터 소스 모드 집합에 기본 모드가 없습니다.
STATUS_GRAPHICS_INVALID_MONITOR_SOURCEMODESET hMonitorSourceModeSet에 제공된 핸들이 잘못되었습니다.

설명

D3DKMDT_MONITOR_SOURCE_MODE 구조체 사용을 마치면 pfnReleaseModeInfo를 호출하여 구조를 해제해야 합니다.

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

요구 사항

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