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 |
Library | Ddraw.lib |
[DLL] | Ddraw.dll |