DISPLAYCONFIG_TARGET_DEVICE_NAME 结构 (wingdi.h)

项目
08/27/2023

DISPLAYCONFIG_TARGET_DEVICE_NAME 结构包含有关目标的信息。

语法

typedef struct DISPLAYCONFIG_TARGET_DEVICE_NAME {
  DISPLAYCONFIG_DEVICE_INFO_HEADER       header;
  DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS flags;
  DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY  outputTechnology;
  UINT16                                 edidManufactureId;
  UINT16                                 edidProductCodeId;
  UINT32                                 connectorInstance;
  WCHAR                                  monitorFriendlyDeviceName[64];
  WCHAR                                  monitorDevicePath[128];
} DISPLAYCONFIG_TARGET_DEVICE_NAME;

成员

header

包含有关目标设备名称请求的信息的DISPLAYCONFIG_DEVICE_INFO_HEADER 结构。调用方应将 DISPLAYCONFIG_DEVICE_INFO_HEADER 的类型 成员设置为 DISPLAYCONFIG_DEVICE_INFO_GET_TARGET_NAME，并将 DISPLAYCONFIG_DEVICE_INFO_HEADER 的 adapterId 和 id 成员设置为调用方需要目标设备名称的目标。调用方应将 DISPLAYCONFIG_DEVICE_INFO_HEADER 的大小 成员至少设置为DISPLAYCONFIG_TARGET_DEVICE_NAME结构的大小。

flags

一个DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS结构，用于在位字段标志中标识有关目标的信息。

outputTechnology

DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY 枚举中的值，该值指定目标的连接器类型。

edidManufactureId

监视器扩展显示标识数据的制造标识符 (EDID) 。仅当标志成员中设置了 edidIdsValid 位字段时，才会设置此成员。

edidProductCodeId

监视器 EDID 中的产品代码。仅当标志成员中设置了 edidIdsValid 位字段时，才会设置此成员。

connectorInstance

仅当适配器具有此类型的多个目标时，此特定目标的从 1 开始的实例编号。连接器实例是一个连续的从 1 开始的数字，在每个适配器中是唯一的。如果这是适配器上此类型的唯一目标，则此值为零。

monitorFriendlyDeviceName[64]

一个以 NULL 结尾的 WCHAR 字符串，该字符串是监视器的设备名称。此名称可与 SetupAPI.dll 一起使用，以获取安装包中包含的设备名称。

monitorDevicePath[128]

一个以 NULL 结尾的 WCHAR 字符串，该字符串是监视器的设备名称的路径。此路径可与 SetupAPI.dll 一起使用，以获取安装包中包含的设备名称。

注解

扩展显示标识数据 (EDID) 是由显示器提供的一组数据，用于向图形适配器描述其功能。 EDID 数据允许计算机检测连接到它的监视器类型。 EDID 数据包括制造商名称、产品类型、显示器支持的计时、显示大小以及其他显示特征。 EDID 由视频电子标准协会 (VESA) 发布的标准定义。

命名设备对象具有 \Device\DeviceName 格式的路径和名称。这称为设备对象的设备名称。

如果应用程序调用 DisplayConfigGetDeviceInfo 函数来获取监视器名称，并且 DisplayConfigGetDeviceInfo 无法获取监视器名称，或者在未连接监视器的情况下强制目标，则 DISPLAYCONFIG_TARGET_DEVICE_NAME 结构的 monitorFriendlyDeviceName 成员中的字符串为 NULL 字符串，并且未设置DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS 结构中的位字段标志。