IDirectDraw7::SetDisplayMode 메서드(ddraw.h)
디스플레이 디바이스 하드웨어의 모드를 설정합니다.
구문
HRESULT SetDisplayMode(
[in] DWORD unnamedParam1,
[in] DWORD unnamedParam2,
[in] DWORD unnamedParam3,
[in] DWORD unnamedParam4,
[in] DWORD unnamedParam5
);
매개 변수
[in] unnamedParam1
새 디스플레이 모드의 너비입니다.
[in] unnamedParam2
새 디스플레이 모드의 높이입니다.
[in] unnamedParam3
새 디스플레이 모드의 픽셀당 비트(bpp)입니다.
[in] unnamedParam4
새 디스플레이 모드의 새로 고침 빈도입니다. 드라이버의 기본 새로 고침 속도를 요청하려면 이 값을 0으로 설정합니다.
[in] unnamedParam5
이 값은 추가 옵션을 설명하는 플래그로 구성됩니다. 현재 유효한 플래그는 DDSDM_STANDARDVGAMODE 때문에 모드 X 320x200x8 모드 대신 메서드가 모드 13을 설정합니다. 다른 해상도, 비트 깊이 또는 모드 X 모드를 설정하는 경우 이 플래그를 사용하지 마세요. 대신 매개 변수를 0으로 설정합니다.
반환 값
메서드가 성공하면 반환 값이 DD_OK.
실패하면 메서드는 다음 오류 값 중 하나를 반환할 수 있습니다.
- DDERR_GENERIC
- DDERR_INVALIDMODE
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_LOCKEDSURFACES
- DDERR_NOEXCLUSIVEMODE
- DDERR_SURFACEBUSY
- DDERR_UNSUPPORTED
- DDERR_UNSUPPORTEDMODE
- DDERR_WASSTILLDRAWING
설명
이 메서드는 애플리케이션 창을 만든 동일한 스레드에서 호출해야 합니다.
다른 응용 프로그램이 디스플레이 모드를 변경하면 기본 표면이 손실되고 기본 표면이 새 디스플레이 모드와 일치하도록 다시 생성될 때까지 메서드가 DDERR_SURFACELOST 반환합니다.
이전 버전 IDirectDraw 인터페이스의 일부로 이 메서드에는 dwRefreshRate 및 dwFlags 매개 변수가 포함되지 않았습니다.
요구 사항
| 대상 플랫폼 | Windows |
| 헤더 | ddraw.h |
| 라이브러리 | Ddraw.lib |
| DLL | Ddraw.dll |