IDirect3D9Ex::GetAdapterDisplayModeEx 메서드(d3d9.h)

어댑터의 현재 디스플레이 모드 및 회전 설정을 검색합니다.

구문

HRESULT GetAdapterDisplayModeEx(
  [in]      UINT               Adapter,
  [in, out] D3DDISPLAYMODEEX   *pMode,
  [in, out] D3DDISPLAYROTATION *pRotation
);

매개 변수

[in] Adapter

형식: UINT

쿼리할 디스플레이 어댑터를 나타내는 서수입니다. D3DADAPTER_DEFAULT 항상 기본 디스플레이 어댑터입니다.

[in, out] pMode

형식: D3DDISPLAYMODEEX*

어댑터의 표시 모드에 대한 데이터를 포함하는 D3DDISPLAYMODEEX 구조체에 대한 포인터입니다. 디바이스가 전체 화면 모드를 소유하지 않는 경우 활성화되지 않을 수 있는 디바이스의 표시 모드와는 반대로 NULL로 설정할 수 있습니다.

[in, out] pRotation

형식: D3DDISPLAYROTATION*

애플리케이션이 수행할 화면 회전 유형을 나타내는 D3DDISPLAYROTATION 구조체에 대한 포인터입니다. 이 포인터를 통해 반환되는 값은 D3DPRESENTFLAG_NOAUTOROTATE 플래그를 사용할 때 중요합니다. 그렇지 않으면 NULL로 설정할 수 있습니다.

반환 값

형식: HRESULT

메서드가 성공하면 반환 값이 D3D_OK.

어댑터가 범위를 벗어났거나 pMode가 잘못된 경우 이 메서드는 D3DERR_INVALIDCALL 반환합니다.

설명

GetAdapterDisplayModeEx 는 디스플레이가 2:10:10:10과 같은 확장 형식인 경우 올바른 형식을 반환하지 않습니다. 대신 X8R8G8B8 형식을 반환합니다.

창이 있는 애플리케이션의 경우 PresentEx 또는 CheckDeviceState 에서 반환된 S_PRESENT_MODE_CHANGED 값은 디스플레이 모드가 변경되었으며 현재 디스플레이 모드의 형식이 다를 수 있음을 나타냅니다. 색 변환 Present Blt를 방지하기 위해 창 애플리케이션은 필요에 따라 이 메서드를 사용하고 그에 따라 스왑 체인 형식을 조정하여 새 디스플레이 모드 정보를 가져올 수 있습니다. 이 메서드는 이 헤드가 더 이상 데스크톱에 속하지 않거나 모니터의 연결이 끊어지면 D3DERR_NOTAVAILABLE 반환합니다.

요구 사항

대상 플랫폼	Windows
헤더	d3d9.h
라이브러리	D3D9.lib

추가 정보

IDirect3D9Ex