EnumDisplaySettings函式得到顯示設備的一個圖形模式設備，通過對該函式一系列的調用可以得到顯示設備所有的圖形模式信息。
基本介紹
- 中文名：EnumDisplaySettings
- 速查：Windows
- NT：3.51及以上版本
- Windows：95及以上版本
定義,參數說明,
定義
函式功能：
函式原型：BOOL EnumDisplaySettings(LPCTSTR lpszDeviceName, DWORD iModeNum, LPDEVMODE lpDevMode)；
參數說明
lpszDeviceName：指向一個以null的結尾的字元串，該字元串指定了顯示設備。此函式將獲得該顯示設備的圖形模式信息。該參數可以為NULL。NULL值表明調用執行緒正運行在計算機的當前顯示設備上。如果lpszDeviceName為NULL，該字元串的形式為\\.\displayx，其中x的值可以為1、2或3。對於Windows 95和Windows 98，lpszDeviceName必須為NULL。
iModeNum：表明要檢索的信息類型，該值可以是一個圖形模式索引，也可以是下列一值：
ENUM_CURRENT_SETTINGS：檢索顯示設備的當前設定。
ENUM_REGISTRY_SETTINGS：檢索當前存儲在註冊表中的顯示設備的設定。
圖形模式索引值從零開始，要得到一個顯示設備的所有圖形模式信息，可以一系列地調用EnumDisplaySettings函式，並且iModeNum顯為一個非零值時，則函式返回的信息是最近一次使用iModeNum置為零調用該函式時存儲的信息。
lpDevMode：DEVMODE結構的指針，該結構存儲指定圖形模式的信息，在調用EnumDisplaySettings之前，設定dmSize為sizeof(DEVMODE)，並且以位元組為單位，設定dmDriveExtra元素為接收專用驅動數據可用的附加空間。
EnumDisplaySettings函式設定如下五個DEVMODE元素的值：dmBitsPerpel、dmPelsWidth、dmPelsHeight、dmDisplayFlags、dmDisplayFrequency。
返回值：如果成功，返回非零值；如果失敗，返回零。
Windows NT：若想獲得更多錯誤信息，請調用GetLastError函式。
注釋：如果iModeNum大於顯示設備最後的圖形模式索引，那么函式就會失敗，如同在iModeNum參數中描述的那樣，使用這種方法可以枚舉顯示設備所有的圖形模式。
