Platform SDK: DirectX

DirectDraw7.SetDisplayMode

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

object.SetDisplayMode( _ 
    w As Long, _ 
    h As Long, _ 
    bpp As Long, _ 
    ref As Long, _ 
    mode As CONST_DDSDMFLAGS)

パラメータ

object
DirectDraw7 オブジェクトを表すオブジェクト式。
wh
新しいモードの幅と高さ。
bpp
解像度、新しいモードのビット/ピクセル (bpp)。
ref
新しいモードのリフレッシュ レート。この値を 0 に設定すると、ドライバに対するデフォルトのリフレッシュ レートを要求する。
mode
追加オプションを記述する CONST_DDSDMFLAGS 列挙の定数の 1 つ。現時点で唯一の有効なフラグは DDSDM_STANDARDVGAMODE であり、メソッドでモード X の 320×200×8 モードではなく、モード 13 を設定できる。別の解像度、ビット深度、またはモード X モードに設定する場合は、このフラグを使用せずにパラメータを 0 に設定する。

エラー コード

失敗すればエラーが発生し、Err.Number に次のいずれかの値が設定される。

DDERR_GENERIC
DDERR_INVALIDMODE
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_LOCKEDSURFACES
DDERR_NOEXCLUSIVEMODE
DDERR_SURFACEBUSY
DDERR_UNSUPPORTED
DDERR_UNSUPPORTEDMODE
DDERR_WASSTILLDRAWING

注意

このメソッドは、アプリケーション ウィンドウを作成した同じスレッドで呼び出されなくてはならない。

別のアプリケーションがディスプレイ モードを変更する場合、プライマリ サーフェスは消失され、新しいディスプレイ モードに適合するようにプライマリ サーフェスが再作成されるまで、DDERR_SURFACELOST を返す。

参照

DirectDraw7.RestoreDisplayModeDirectDraw7.GetDisplayModesEnumDirectDraw7.SetCooperativeLevelディスプレイ モードの設定ディスプレイ モードのリストア