共用方式為


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
ERROR_SUCCESS
此函數已成功。
ERROR_INVALID_PARAMETER
指定的參數和旗標的組合無效。
ERROR_NOT_SUPPORTED
系統未執行根據 Windows 顯示驅動程式模型所撰寫的圖形驅動程式, (WDDM) 。 只有在執行 WDDM 驅動程式的系統上才支援函式。
ERROR_ACCESS_DENIED
呼叫端無法存取主控台工作階段。 如果呼叫進程沒有目前桌面的存取權,或是在遠端會話上執行,就會發生此錯誤。
ERROR_INSUFFICIENT_BUFFER
呼叫端所傳遞的封包大小不夠大。
ERROR_GEN_FAILURE
發生未指定的錯誤。

備註

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 版中引進)

另請參閱

DISPLAYCONFIG_DEVICE_INFO_HEADER

DisplayConfigGetDeviceInfo