DISPLAYCONFIG_TARGET_DEVICE_NAME 结构 (wingdi.h)

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 的 adapterIdid 成员设置为调用方需要目标设备名称的目标。 调用方应将 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 结构中的位字段标志。

要求

要求
最低受支持的客户端 在 Windows 7 客户端中可用。
标头 wingdi.h (包括 Windows.h)

另请参阅

DISPLAYCONFIG_DEVICE_INFO_HEADER

DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS

DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY

DisplayConfigGetDeviceInfo