EnumDisplaySettingsA 函式 (winuser.h)

發行項
08/27/2023

EnumDisplaySettings函式會擷取顯示裝置其中一種圖形模式的相關資訊。若要擷取顯示裝置所有圖形模式的資訊，請對此函式進行一系列的呼叫。

注意您設計以 Windows 8 和更新版本為目標的應用程式無法再查詢或設定每個圖元小於 32 位的顯示模式， (bpp) ;這些作業將會失敗。這些應用程式具有以 Windows 8 為目標的相容性資訊清單。 Windows 8 仍支援在沒有 Windows 8 資訊清單的情況下建置傳統型應用程式的 8 位和 16 位色彩模式;Windows 8 會模擬這些模式，但仍以 32 位色彩模式執行。

語法

BOOL EnumDisplaySettingsA(
  [in]  LPCSTR   lpszDeviceName,
  [in]  DWORD    iModeNum,
  [out] DEVMODEA *lpDevMode
);

參數

[in] lpszDeviceName

Null 終止字串的指標，指定函式將取得資訊之圖形模式的相關顯示裝置。

此參數為Null或DISPLAY_DEVICE。從EnumDisplayDevices傳回的DeviceName。 Null值會指定呼叫執行緒執行所在電腦上的目前顯示裝置。

[in] iModeNum

要擷取的資訊類型。此值可以是圖形模式索引或下列其中一個值。

值	意義
ENUM_CURRENT_SETTINGS	擷取顯示裝置的目前設定。
ENUM_REGISTRY_SETTINGS	擷取目前儲存在登錄中的顯示裝置設定。

圖形模式索引從零開始。若要取得所有顯示裝置圖形模式的資訊，請對 EnumDisplaySettings進行一系列的呼叫，如下所示：將 iModeNum 設定為零進行第一次呼叫，並為每個後續呼叫遞增 iModeNum 。繼續呼叫函式，直到傳回值為零為止。

當您使用iModeNum設定為零呼叫EnumDisplaySettings時，作業系統會初始化並快取顯示裝置的相關資訊。當您使用iModeNum設定為非零值呼叫EnumDisplaySettings時，函式會傳回上次以iModeNum設定為零呼叫函式時快取的資訊。

[out] lpDevMode

DEVMODE結構的指標，函式會儲存指定圖形模式的相關資訊。呼叫 EnumDisplaySettings之前，請將 dmSize 成員設定為 sizeof(DEVMODE) ，並將 dmDriverExtra 成員設定為，以位元組為單位來表示可接收私人驅動程式資料的額外空間大小。

EnumDisplaySettings函式會設定下列五個DEVMODE成員的值：

dmBitsPerPel
dmPelsWidth
dmPelsHeight
dmDisplayFlags
dmDisplayFrequency

傳回值

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。

備註

如果 iModeNum 大於顯示裝置最後一個圖形模式的索引，則函式會失敗。如 iModeNum 參數的描述所述，您可以使用此行為來列舉所有顯示裝置的圖形模式。

DPI 虛擬化

此 API 不會參與 DPI 虛擬化。指定的輸出一律以實體圖元為單位，而且與呼叫內容無關。

注意

winuser.h 標頭會將 EnumDisplaySettings 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

規格需求


最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	winuser.h (包括 Windows.h)
程式庫	User32.lib
Dll	User32.dll
API 集合	在 Windows 8) 中引進的 ext-ms-win-ntuser-sysparams-ext-l1-1-0 (