DisplayConfigGetDeviceInfo 函式 (winuser.h)

DisplayConfigGetDeviceInfo 函式會擷取裝置的顯示組態資訊。

語法

LONG DisplayConfigGetDeviceInfo(
  [in, out] DISPLAYCONFIG_DEVICE_INFO_HEADER *requestPacket
);

[in, out] requestPacket

DISPLAYCONFIG_DEVICE_INFO_HEADER 結構的指標。此結構包含要求的相關信息，其中包含類型成員中的封包類型。 DisplayConfigGetDeviceInfo 在標頭結構之後傳回的其他數據類型和大小取決於封包類型。

函式會傳回下列其中一個傳回碼。

傳回碼	Description
ERROR_SUCCESS	此函數已成功。
ERROR_INVALID_PARAMETER	指定的參數和旗標組合無效。
ERROR_NOT_SUPPORTED	系統未執行根據 Windows 顯示驅動程式模型所撰寫的圖形驅動程式， (WDDM) 。只有在執行 WDDM 驅動程式的系統上才支援函式。
ERROR_ACCESS_DENIED	呼叫端無法存取主控台工作階段。如果呼叫進程無法存取目前的桌面或在遠端會話上執行，就會發生此錯誤。
ERROR_INSUFFICIENT_BUFFER	呼叫端傳遞的封包大小不足以滿足呼叫端要求的資訊。
ERROR_GEN_FAILURE	發生未指定的錯誤。

使用 DisplayConfigGetDeviceInfo 函式來取得適配卡來源或目標的其他資訊，例如顯示名稱、慣用的顯示模式，以及來源裝置名稱。

呼叫端可以呼叫 DisplayConfigGetDeviceInfo ，以取得更易記的名稱，以顯示在使用者介面中。呼叫端可以取得配接器、來源和目標的名稱。呼叫端也可以呼叫 DisplayConfigGetDeviceInfo ，以取得連線顯示器裝置的最佳解析度。

如需 DisplayConfigGetDeviceInfo 的範例，請參閱 QueryDisplayConfig。

需求	值
最低支援的用戶端	可在 Windows Vista 和更新版本的 Windows 作業系統中使用。
目標平台	Universal
標頭	winuser.h (包含 Windows.h)
程式庫	User32.lib;Windows 10 上的 OneCoreUAP.lib
Dll	User32.dll
API 集合	ext-ms-win-ntuser-sysparams-ext-l1-1-1 (Windows 10 10.0.14393 版)