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。

返回值

函数返回以下返回代码之一。

返回代码 说明
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 操作系统中可用。
目标平台 通用
标头 winuser.h (包括 Windows.h)
Library User32.lib;Windows 10 上的 OneCoreUAP.lib
DLL User32.dll
API 集 Windows 10版本 10.0.14393 中引入的 ext-ms-win-ntuser-sysparams-ext-l1-1-1 ()

另请参阅

DISPLAYCONFIG_DEVICE_INFO_HEADER

DisplayConfigGetDeviceInfo