wingdi.h) (DISPLAY_DEVICEA结构

DISPLAY_DEVICE 结构接收有关由 EnumDisplayDevices 函数的 iDevNum 参数指定的显示设备的信息。

语法

typedef struct _DISPLAY_DEVICEA {
  DWORD cb;
  CHAR  DeviceName[32];
  CHAR  DeviceString[128];
  DWORD StateFlags;
  CHAR  DeviceID[128];
  CHAR  DeviceKey[128];
} DISPLAY_DEVICEA, *PDISPLAY_DEVICEA, *LPDISPLAY_DEVICEA;

成员

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 参数为 NULL，则DISPLAY_DEVICE填充有关显示适配器的信息 (s) 。 如果它是有效的设备名称，则会用有关该设备的监视器 () 的信息填充它。

注意

wingdi.h 标头将 DISPLAY_DEVICE 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	wingdi.h (包括 Windows.h)

另请参阅

设备上下文结构

设备上下文概述

EnumDisplayDevices

GetSystemMetrics