共用方式為


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 版)

另請參閱

DISPLAYCONFIG_DEVICE_INFO_HEADER

DISPLAYCONFIG_TARGET_DEVICE_NAME

DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS

DisplayConfigSetDeviceInfo