Platform SDK: DirectX

IDirectDraw7::SetDisplayMode

IDirectDraw7::SetDisplayMode メソッドは、ディスプレイデバイス ハードウェアのモードを設定する。

HRESULT SetDisplayMode(
  DWORD dwWidth, 
  DWORD dwHeight, 
  DWORD dwBPP, 
  DWORD dwRefreshRate, 
  DWORD dwFlags 
);

パラメータ

dwWidthdwHeight
新しいモードの幅と高さ。
dwBPP
新しいモードのビット/ピクセル (bpp)。
dwRefreshRate
新しいモードのリフレッシュ レート。この値を 0 に設定すると、ドライバに対するデフォルト リフレッシュ レートを要求する。
dwFlags
追加オプションを記述するフラグ。現時点で唯一の有効なフラグは DDSDM_STANDARDVGAMODE であり、メソッドでモード X の 320 × 200 × 8 モードではなく、モード 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 NT/2000 :Windows 2000 が必要。
  Windows 95/98 : Windows 98 が必要。
  ヘッダー : ddraw.h で宣言。

参照

IDirectDraw7::RestoreDisplayModeIDirectDraw7::GetDisplayModeIDirectDraw7::EnumDisplayModesIDirectDraw7::SetCooperativeLevelディスプレイ モードの設定ディスプレイ モードのリストア