IDirect3D9::EnumAdapterModes 메서드(d3d9.h)

디바이스를 쿼리하여 지정된 어댑터가 요청된 형식 및 디스플레이 모드를 지원하는지 여부를 확인합니다. 이 메서드는 루프에서 사용 가능한 모든 어댑터 모드를 열거하는 데 사용할 수 있습니다.

구문

HRESULT EnumAdapterModes(
  [in]  UINT           Adapter,
  [in]  D3DFORMAT      Format,
  [in]  UINT           Mode,
  [out] D3DDISPLAYMODE *pMode
);

매개 변수

[in] Adapter

형식: UINT

열거할 디스플레이 어댑터를 나타내는 서수입니다. D3DADAPTER_DEFAULT 항상 기본 디스플레이 어댑터입니다. 이 메서드는 이 값이 시스템의 디스플레이 어댑터 수와 같거나 초과할 때 D3DERR_INVALIDCALL 반환합니다.

[in] Format

형식: D3DFORMAT

허용 가능한 픽셀 형식입니다. 설명 부분을 참조하세요.

[in] Mode

형식: UINT

0과 GetAdapterModeCount 에서 반환된 값에서 1을 뺀 값 사이의 부호 없는 정수인 표시 모드 인덱스를 나타냅니다.

[out] pMode

형식: D3DDISPLAYMODE*

D3DDISPLAYMODE 형식의 사용 가능한 표시 모드에 대한 포인터입니다. 설명 부분을 참조하세요.

반환 값

형식: HRESULT

• 이 어댑터에서 디바이스를 사용할 수 있는 경우 D3D_OK 반환됩니다.
• 어댑터가 시스템의 디스플레이 어댑터 수와 같거나 초과하면 D3DERR_INVALIDCALL 반환됩니다.
• 표면 형식이 지원되지 않거나 지정된 형식에 하드웨어 가속을 사용할 수 없는 경우 D3DERR_NOTAVAILABLE 반환됩니다.

설명

애플리케이션은 디스플레이 모드를 반환하는 EnumAdapterModes 에 디스플레이 모드 및 형식을 제공합니다. 이 메서드는 루프에서 사용 가능한 모든 디스플레이 모드를 열거하는 데 사용할 수 있습니다.

애플리케이션은 형식을 지정하고 열거형은 형식과 정확히 일치하는 표시 모드로 제한됩니다(알파는 무시됨). 허용되는 형식( D3DFORMAT의 멤버)은 다음과 같습니다.

• D3DFMT_A1R5G5B5
• D3DFMT_A2R10G10B10
• D3DFMT_A8R8G8B8
• D3DFMT_R5G6B5
• D3DFMT_X1R5G5B5
• D3DFMT_X8R8G8B8

또한 EnumAdapterModes 는 픽셀 형식 565 및 555를 동등한 형식으로 처리하고 올바른 버전을 반환합니다. 애플리케이션이 백 버퍼를 잠그고 이를 수행하기 위해 애플리케이션이 설정해야 하는 명시적 플래그가 있는 경우에만 차이가 발생합니다.

요구 사항

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

추가 정보

IDirect3D9