EnumDisplayDevicesW 函式 (winuser.h)

發行項
08/27/2023

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

語法

BOOL EnumDisplayDevicesW(
  [in]  LPCWSTR          lpDevice,
  [in]  DWORD            iDevNum,
  [out] PDISPLAY_DEVICEW 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 標頭會根據 UNICODE 預處理器常數的定義，將 EnumDisplayDevices 定義為別名，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

規格需求


最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	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 版)