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

Header windows.h
Windows Embedded CE Windows CE .NET 4.2 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

EnumDisplayDevices
GetSystemMetrics
GDI Structures