Функция 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)
Библиотека User32.lib; OneCoreUAP.lib в Windows 10
DLL User32.dll
Набор API ext-ms-win-ntuser-sysparams-ext-l1-1-1 (представлено в Windows 10 версии 10.0.14393)

См. также раздел

DISPLAYCONFIG_DEVICE_INFO_HEADER

DISPLAYCONFIG_TARGET_DEVICE_NAME

DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS

DisplayConfigSetDeviceInfo