DisplayConfigGetDeviceInfo 函式會擷取裝置的顯示組態資訊。
語法
LONG DisplayConfigGetDeviceInfo(
[in, out] DISPLAYCONFIG_DEVICE_INFO_HEADER *requestPacket
);
參數
[in, out] requestPacket
DISPLAYCONFIG_DEVICE_INFO_HEADER 結構的指標。 此結構包含要求的相關信息，其中包含類型成員中的封包 類型 。 DisplayConfigGetDeviceInfo 在標頭結構之後傳回的其他數據類型和大小取決於封包類型。
傳回值
函式會傳回下列其中一個傳回碼。
| 傳回碼 | Description |
|---|---|
|
此函數已成功。 |
|
指定的參數和旗標組合無效。 |
|
系統未執行根據 Windows 顯示驅動程式模型所撰寫的圖形驅動程式 ， (WDDM) 。 只有在執行 WDDM 驅動程式的系統上才支援函式。 |
|
呼叫端無法存取主控台工作階段。 如果呼叫進程無法存取目前的桌面或在遠端會話上執行，就會發生此錯誤。 |
|
呼叫端傳遞的封包大小不足以滿足呼叫端要求的資訊。 |
|
發生未指定的錯誤。 |
備註
使用 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