共用方式為


EnumDisplayDevicesA 函式 (winuser.h)

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_DEVICEDeviceString 包含配接器名稱。

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

若要查詢與配接器相關聯的所有監視裝置,請在迴圈中呼叫 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 版)

另請參閱

ChangeDisplaySettings

ChangeDisplaySettingsEx

CreateDC

DEVMODE

DISPLAY_DEVICE

裝置內容函式

裝置內容概觀

EnumDisplaySettings