共用方式為

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