DisplayConfigSetDeviceInfo 函式 (winuser.h)
DisplayConfigSetDeviceInfo 函式會設定目標的屬性。
語法
LONG DisplayConfigSetDeviceInfo(
[in] DISPLAYCONFIG_DEVICE_INFO_HEADER *setPacket
);
參數
[in] setPacket
DISPLAYCONFIG_DEVICE_INFO_HEADER 結構的指標，其中包含要為裝置設定的資訊。 DisplayConfigSetDeviceInfo 用於設定的其他數據類型和大小會在標頭結構之後出現。 此額外數據取決於封包類型，如DISPLAYCONFIG_DEVICE_INFO_HEADER 的類型 成員所指定。 例如，如果呼叫端想要變更開機持續性，該呼叫端會配置並填入 DISPLAYCONFIG_SET_TARGET_PERSISTENCE 結構，並在 setPacket 中傳遞此結構的指標。 請注意，DISPLAYCONFIG_SET_TARGET_PERSISTENCE 結構的第一個成員是DISPLAYCONFIG_DEVICE_INFO_HEADER。
傳回值
函式會傳回下列其中一個傳回碼。
| 傳回碼 | Description |
|---|---|
|
此函數已成功。 |
|
指定的參數和旗標的組合無效。 |
|
系統未執行根據 Windows 顯示驅動程式模型所撰寫的圖形驅動程式， (WDDM) 。 只有在執行 WDDM 驅動程式的系統上才支援函式。 |
|
呼叫端無法存取主控台工作階段。 如果呼叫進程沒有目前桌面的存取權，或是在遠端會話上執行，就會發生此錯誤。 |
|
呼叫端所傳遞的封包大小不夠大。 |
|
發生未指定的錯誤。 |
備註
DisplayConfigSetDeviceInfo 目前只能用來在模擬目標上啟動和停止開機持續性強制投影。 如需開機持續性的詳細資訊，請參閱 強制與連線的目標。
DisplayConfigSetDeviceInfo 只能用來設定資訊類型DISPLAYCONFIG_DEVICE_INFO_SET_XXX。 如果 DISPLAYCONFIG_DEVICE_INFO_HEADER的類型成員設定為其中一個DISPLAYCONFIG_DEVICE_INFO_GET_XXX值，DisplayConfigSetDeviceInfo 就會失敗。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 可在 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 版中引進) |