Platform SDK: DirectX |
IDirectDraw7::SetDisplayMode メソッドは、ディスプレイデバイス ハードウェアのモードを設定する。
HRESULT SetDisplayMode( DWORD dwWidth, DWORD dwHeight, DWORD dwBPP, DWORD dwRefreshRate, DWORD dwFlags );
成功すれば、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 NT/2000 :Windows 2000 が必要。
Windows 95/98 : Windows 98 が必要。
ヘッダー : ddraw.h で宣言。
IDirectDraw7::RestoreDisplayMode、IDirectDraw7::GetDisplayMode、IDirectDraw7::EnumDisplayModes、IDirectDraw7::SetCooperativeLevel、ディスプレイ モードの設定、ディスプレイ モードのリストア