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，這會導致 方法設定 Mode 13，而不是 Mode X 320x200x8 模式。 如果您要設定另一個解析度、位深度或 Mode 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 |