EnumDisplaySettings

EnumDisplaySettings,計算機語言函式,該函式得到顯示設備的一個圖形模式設備,通過對該函式一系列的調用可以得到顯示設備所有的圖形模式信息。

功能原理

函式功能:該函式得到顯示設備的一個圖形模式設備,通過對該函式一系列的調用可以得到顯示設備所有的圖形模式信息。
函式原型: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參數中描述的那樣,使用這種方法可以枚舉顯示設備所有的圖形模式。
速查:Windows NT:3.51及以上版本;Windows:95及以上版本;Windows CE:不支持;頭檔案:winuser.h;庫檔案:user32.lib;Unicode:在Windows NT上實現為Unicode和ANSI兩種版本。

相關詞條

相關搜尋

熱門詞條

聯絡我們