структура 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, а элементы adapterId и id DISPLAYCONFIG_DEVICE_INFO_HEADER целевому объекту, для которого вызывающему объекту требуется имя целевого устройства. Вызывающий объект должен задать размер элемента DISPLAYCONFIG_DEVICE_INFO_HEADER как минимум размер структуры DISPLAYCONFIG_TARGET_DEVICE_NAME.
flags
Структура DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS , определяющая в флагах битовых полей сведения о целевом объекте.
outputTechnology
Значение из перечисления DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY , указывающее тип соединителя целевого объекта.
edidManufactureId
Идентификатор производства из расширенных идентификационных данных монитора (EDID). Этот элемент задается только в том случае, если битовое поле edidIdsValid задано в элементе flags .
edidProductCodeId
Код продукта из монитора EDID. Этот элемент задается только в том случае, если битовое поле edidIdsValid задано в элементе flags .
connectorInstance
Номер экземпляра этого конкретного целевого объекта только в том случае, если адаптер имеет несколько целевых объектов этого типа. Экземпляр соединителя — это последовательный одноуровневый номер, уникальный в пределах каждого адаптера. Если это единственный целевой объект этого типа на адаптере, это значение равно нулю.
monitorFriendlyDeviceName[64]
Строка WCHAR с завершением NULL, которая является именем устройства для монитора. Это имя можно использовать с SetupAPI.dll для получения имени устройства, содержащегося в пакете установки.
monitorDevicePath[128]
Строка WCHAR, завершающаяся null, которая является путем к имени устройства для монитора. Этот путь можно использовать с SetupAPI.dll для получения имени устройства, содержащегося в пакете установки.
Комментарии
Расширенные данные идентификации дисплея (EDID) — это набор данных, предоставляемых дисплеем для описания его возможностей графического адаптера. Данные EDID позволяют компьютеру определять тип монитора, подключенного к нему. Данные EDID включают имя производителя, тип продукта, время, поддерживаемую дисплеем, размер дисплея, а также другие характеристики дисплея. EDID определяется стандартом, опубликованным Ассоциацией стандартов видеоэлектроники (VESA).
Именованный объект устройства имеет путь и имя в формате \Device\DeviceName. Это называется именем объекта устройства.
Если приложение вызывает функцию DisplayConfigGetDeviceInfo для получения имени монитора, а DisplayConfigGetDeviceInfo либо не может получить имя монитора, либо целевой объект принудительно используется без подключенного монитора, строка в элементе monitorFriendlyDeviceName структуры DISPLAYCONFIG_TARGET_DEVICE_NAME является строкой NULL и ни один из флагов битовых полей в структуре DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS не задан.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в клиенте Windows 7. |
| Верхняя часть | wingdi.h (включая Windows.h) |
См. также раздел
DISPLAYCONFIG_DEVICE_INFO_HEADER
DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS