displayConfigGetDeviceInfo 函数 (winuser.h)

DisplayConfigGetDeviceInfo 函数检索有关设备的显示配置信息。

语法

LONG DisplayConfigGetDeviceInfo(
  [in, out] DISPLAYCONFIG_DEVICE_INFO_HEADER *requestPacket
);

[in, out] requestPacket

指向 DISPLAYCONFIG_DEVICE_INFO_HEADER 结构的指针。此结构包含有关请求的信息，其中包括类型成员中的数据包类型。 DisplayConfigGetDeviceInfo 在标头结构后返回的其他数据的类型和大小取决于数据包类型。

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

返回代码	说明
ERROR_SUCCESS	函数成功。
ERROR_INVALID_PARAMETER	指定的参数和标志的组合无效。
ERROR_NOT_SUPPORTED	系统未运行根据 Windows 显示驱动程序模型 (WDDM) 编写的图形驱动程序。仅在运行 WDDM 驱动程序的系统上支持函数。
ERROR_ACCESS_DENIED	调用方无权访问控制台会话。如果调用进程无权访问当前桌面或在远程会话上运行，则会发生此错误。
ERROR_INSUFFICIENT_BUFFER	调用方传递的数据包的大小不足以容纳调用方请求的信息。
ERROR_GEN_FAILURE	发生了未指定的错误。

使用 DisplayConfigGetDeviceInfo 函数获取有关适配器的源或目标的其他信息，例如显示名称、首选显示模式和源设备名称。

调用方可以调用 DisplayConfigGetDeviceInfo 以获取要显示在用户界面中的更友好名称。调用方可以获取适配器、源和目标的名称。调用方还可以调用 DisplayConfigGetDeviceInfo 以获取连接显示设备的最佳分辨率。

有关 DisplayConfigGetDeviceInfo 的示例，请参阅 QueryDisplayConfig。

要求	值
最低受支持的客户端	在 Windows Vista 和更高版本的 Windows 操作系统中可用。
目标平台	通用
标头	winuser.h (包括 Windows.h)
Library	User32.lib;Windows 10 上的 OneCoreUAP.lib
DLL	User32.dll
API 集	ext-ms-win-ntuser-sysparams-ext-l1-1-1 (在 Windows 10 版本 10.0.14393 中引入)