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。
返回值
函数返回以下返回代码之一。
返回代码 | 说明 |
---|---|
|
函数成功。 |
|
指定的参数和标志的组合无效。 |
|
系统未运行根据 Windows 显示驱动程序模型 (WDDM) 编写的图形驱动程序。 仅在运行 WDDM 驱动程序的系统上支持函数。 |
|
调用方无权访问控制台会话。 如果调用进程无权访问当前桌面或在远程会话上运行,则会发生此错误。 |
|
调用方传递的数据包大小不够大。 |
|
发生了未指定的错误。 |
注解
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 () |