структура DISPLAY_DEVICEW (wingdi.h)

Статья
11/20/2024

Структура DISPLAY_DEVICE получает сведения об устройстве отображения, указанном параметром iDevNum функции EnumDisplayDevices.

Синтаксис

typedef struct _DISPLAY_DEVICEW {
  DWORD cb;
  WCHAR DeviceName[32];
  WCHAR DeviceString[128];
  DWORD StateFlags;
  WCHAR DeviceID[128];
  WCHAR DeviceKey[128];
} DISPLAY_DEVICEW, *PDISPLAY_DEVICEW, *LPDISPLAY_DEVICEW;

Члены

cb

Размер DISPLAY_DEVICE структуры в байтах. Это необходимо инициализировать перед вызовом EnumDisplayDevices.

DeviceName[32]

Массив символов, определяющих имя устройства. Это либо устройство адаптера, либо устройство монитора.

DeviceString[128]

Массив символов, содержащий строку контекста устройства. Это описание адаптера дисплея или монитора дисплея.

StateFlags

Флаги состояния устройства. Это может быть любое разумное сочетание следующего.

Ценность	Значение
DISPLAY_DEVICE_ACTIVE	DISPLAY_DEVICE_ACTIVE указывает, отображается ли монитор как "включено" соответствующим представлением GDI. Windows Vista: EnumDisplayDevices перечисляет только мониторы, которые можно представить как "включено".
DISPLAY_DEVICE_MIRRORING_DRIVER	Представляет псевдоустройство, используемое для зеркального отображения рисунка приложения для удаленного взаимодействия или других целей. С этим устройством связан невидимый псевдоконтроль. Например, NetMeeting использует его. Обратите внимание, что GetSystemMetrics (SM_MONITORS) только учетные записи для видимых мониторов отображения.
DISPLAY_DEVICE_MODESPRUNED	Устройство имеет больше режимов отображения, чем поддерживаются выходные устройства.
DISPLAY_DEVICE_PRIMARY_DEVICE	Основной рабочий стол находится на устройстве. Для системы с одной карточкой отображения всегда устанавливается. Для системы с несколькими карточками отображения этот набор может иметь только одно устройство.
DISPLAY_DEVICE_REMOVABLE	Устройство является съемным; оно не может быть основным отображением.
DISPLAY_DEVICE_VGA_COMPATIBLE	Устройство совместимо с VGA.

DeviceID[128]

Не используется.

DeviceKey[128]

Скрытный.

Замечания

Четыре элемента строки задаются на основе параметров, передаваемых в EnumDisplayDevices. Если lpDevice param NULL, то DISPLAY_DEVICE заполняется сведениями о адаптерах отображения. Если это допустимое имя устройства, оно заполняется сведениями о мониторах для этого устройства.

Заметка

Заголовок wingdi.h определяет DISPLAY_DEVICE как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
заголовка	wingdi.h (включая Windows.h)

См. также

структуры контекста устройства

Обзор контекстов устройств

EnumDisplayDevices

GetSystemMetrics

Поделиться через