DISPLAY_DEVICE

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This structure receives information about the display device specified by the iDevNum parameter of the EnumDisplayDevices function.

Syntax

typedef struct _DISPLAY_DEVICE {
  DWORD cb;
  WCHAR DeviceName[32];
  WCHAR DeviceString[128];
  DWORD StateFlags;
  WCHAR DeviceID[128];
  WCHAR DeviceKey[128];
} DISPLAY_DEVICE, *PDISPLAY_DEVICE;

Members

• cb
  Size, in bytes, of the DISPLAY_DEVICE structure. This must be initialized prior to calling EnumDisplayDevices.

• DeviceName
  An array of characters that identifies the name of the display device.

  This is either the adapter device or the monitor device.

• DeviceString
  An array of characters that contains the display device context string.

  This is either a description of the display adapter or of the display monitor.

• StateFlags
  One or more device state flags. The following table shows the available flags.

  Flag	Description
  DISPLAY_DEVICE_ATTACHED_TO_DESKTOP	The display device is part of the desktop.
  DISPLAY_DEVICE_MIRRORING_DRIVER	Represents a pseudo device used to mirror application drawing, for remoting or other purposes. An invisible pseudo monitor is associated with this device. GetSystemMetrics(SM_MONITORS) only accounts for visible display monitors.
  DISPLAY_DEVICE_MODESPRUNED	The display device has more display modes than its output devices support.
  DISPLAY_DEVICE_PRIMARY_DEVICE	The primary desktop is on the device. For a system with a single display card, this is always set. For a system with multiple display cards, only one device can have this set.
  DISPLAY_DEVICE_REMOVABLE	The device is removable; it cannot be the primary display.
  DISPLAY_DEVICE_VGA_COMPATIBLE	The device is VGA compatible.

• DeviceID
  Windows 98/Me: A string that uniquely identifies the hardware adapter or the monitor.

  This is the Plug and Play identifier.

• DeviceKey
  Reserved.

Remarks

The four string members are set based on the parameters passed to EnumDisplayDevices.

If the lpDevice parameter is NULL, DISPLAY_DEVICE is filled in with information about the display adapters.

If lpDevice is a valid device name, it is filled in with information about the monitor for that device.

Requirements

See Also

Reference

EnumDisplayDevices
GetSystemMetrics
GDI Structures