Share via

DISPLAY_DEVICE (Compact 2013)

  • Article

3/28/2014

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

Header

windows.h

See Also

Reference

GDI Structures
EnumDisplayDevices
GetSystemMetrics