IDirectDraw7::EnumDisplayModes 方法 (ddraw.h)
列舉硬體透過 DirectDraw 物件公開且與所提供介面描述相容的所有顯示模式。
語法
HRESULT EnumDisplayModes(
[in] DWORD unnamedParam1,
[in] LPDDSURFACEDESC2 unnamedParam2,
[in] LPVOID unnamedParam3,
[in] LPDDENUMMODESCALLBACK2 unnamedParam4
);
參數
[in] unnamedParam1
這個值是由下列一或多個旗標所組成:
DDEDM_REFRESHRATES
列舉具有不同重新整理速率的模式。 IDirectDraw7::EnumDisplayModes 保證只列舉特定模式一次。 此旗標會指定在判斷模式是否是唯一的時,是否將重新整理速率納入考慮。
DDEDM_STANDARDVGAMODES
除了 320x200x8 模式 X 模式之外,還會列舉模式 13。
[in] unnamedParam2
要根據可用模式檢查的 DDSURFACEDESC2 結構的位址。 如果此參數的值是 Null,則會列舉所有模式。
[in] unnamedParam3
要傳遞至每個列舉成員的應用程式定義結構位址。
[in] unnamedParam4
列舉過程在每次找到相符專案時呼叫的 EnumModesCallback2 函式位址。
傳回值
如果方法成功,傳回值會DD_OK。
如果失敗,方法可以傳回下列其中一個錯誤值:
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
備註
IDirectDraw7::EnumDisplayModes列舉DDSURFACEDESC2結構的dwRefreshRate成員;IDirectDraw::EnumDisplayModes 方法沒有這項功能。 如果您使用 IDirectDraw7::SetDisplayMode 方法來設定新模式的重新整理速率,請使用 IDirectDraw7::EnumDisplayModes 來列舉 dwRefreshRate 成員。
IDirectDraw7::EnumDisplayModes 與先前介面中的對應專案不同,因為它接受 EnumModesCallback2 函式的位址做為參數,而不是 EnumModesCallback 函式。
需求
目標平台 | Windows |
標頭 | ddraw.h |
程式庫 | Ddraw.lib |
Dll | Ddraw.dll |