EnumDisplayDevicesA 函式 (winuser.h)

發行項
03/04/2024

EnumDisplayDevices 函式可讓您取得目前會話中顯示裝置的相關信息。

語法

BOOL EnumDisplayDevicesA(
  [in]  LPCSTR           lpDevice,
  [in]  DWORD            iDevNum,
  [out] PDISPLAY_DEVICEA lpDisplayDevice,
  [in]  DWORD            dwFlags
);

參數

[in] lpDevice

裝置名稱的指標。如果 為 NULL，函式會根據 iDevNum，傳回電腦上顯示器配接器 () 的資訊。

如需詳細資訊，請參閱＜備註＞。

[in] iDevNum

索引值，指定感興趣的顯示裝置。

操作系統會以索引值識別目前會話中的每個顯示裝置。索引值是連續的整數，從 0 開始。例如，如果目前的會話有三個顯示裝置，則會由索引值 0、1 和 2 指定。

[out] lpDisplayDevice

DISPLAY_DEVICE 結構的指標，可接收iDevNum所指定之顯示裝置的相關信息。

呼叫 EnumDisplayDevices 之前，您必須將 DISPLAY_DEVICE的 cb 成員初始化為 DISPLAY_DEVICE 的大小，以位元組為單位。

[in] dwFlags

將此旗標設定為 EDD_GET_DEVICE_INTERFACE_NAME (0x00000001) ，以擷取GUID_DEVINTERFACE_MONITOR的裝置介面名稱，而操作系統會根據每個監視器註冊。此值會放在 lpDisplayDevice 中傳回之 DISPLAY_DEVICE 結構的 DeviceID 成員中。產生的裝置介面名稱可以搭配 SetupAPI 函式使用，並做為 GDI 監視器裝置與 SetupAPI 監視器裝置之間的連結。

傳回值

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

如果此函式失敗，則傳回值為零。如果 iDevNum 大於最大裝置索引，則函式會失敗。

備註

若要查詢目前會話中的所有顯示裝置，請在迴圈中呼叫此函式，從 iDevNum 設定為0開始，並在函式失敗之前遞增 iDevNum 。若要選取桌面中的所有顯示裝置，請只使用 DISPLAY_DEVICE 結構中具有DISPLAY_DEVICE_ATTACHED_TO_DESKTOP旗標的顯示裝置。

若要取得顯示配接器的相關信息，請呼叫 EnumDisplayDevices 並將 lpDevice 設定為 NULL。例如， DISPLAY_DEVICE。DeviceString 包含配接器名稱。

若要取得顯示器監視器的相關信息，請先呼叫 EnumDisplayDevices ，並將 lpDevice 設定為 NULL。然後呼叫 EnumDisplayDevices，並將 lpDevice 設定為 DISPLAY_DEVICE。第一次呼叫 EnumDisplayDevices 且 iDevNum 設為零的 DeviceName。然後 DISPLAY_DEVICE。DeviceString 是監視名稱。

若要查詢與配接器相關聯的所有監視裝置，請在迴圈中呼叫 EnumDisplayDevices ，並將 lpDevice 設定為適配卡名稱、 將 iDevNum 設定為從 0 開始，並將 iDevNum 設定為遞增，直到函式失敗為止。請注意， DISPLAY_DEVICE。DeviceName 會隨著每個監視資訊的呼叫而變更，因此您必須儲存適配卡名稱。當配接器沒有其他監視器時，函式會失敗。

注意

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

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	winuser.h (包含 Windows.h)
程式庫	User32.lib
Dll	User32.dll
API 集合	ext-ms-win-ntuser-sysparams-ext-l1-1-1 (Windows 10 10.0.14393 版)