Export (0) Print
Expand All

DISPLAYCONFIG_SOURCE_MODE structure

The DISPLAYCONFIG_SOURCE_MODE structure represents a point or an offset in a two-dimensional space.

Syntax


typedef struct DISPLAYCONFIG_SOURCE_MODE {
  UINT32                    width;
  UINT32                    height;
  DISPLAYCONFIG_PIXELFORMAT pixelFormat;
  POINTL                    position;
} DISPLAYCONFIG_SOURCE_MODE;

Members

width

The width in pixels of the source mode.

height

The height in pixels of the source mode.

pixelFormat

A value from the DISPLAYCONFIG_PIXELFORMAT enumeration that specifies the pixel format of the source mode.

position

A POINTL structure that specifies the position in the desktop coordinate space of the upper-left corner of this source surface. The source surface that is located at (0, 0) is always the primary source surface.

Remarks

The arrangement of source surfaces on the desktop is controlled by the position member, which specifies the position in desktop coordinates of the upper-left corner of the source surface. The source surface that is positioned at (0, 0) is considered the primary. GDI has strict rules about how the source surfaces can be arranged in the desktop space. For example, there cannot be any gaps between source surfaces, and there can be no overlaps.

The SetDisplayConfig function attempts to rearrange source surfaces in order to enforce these layout rules. The caller must make every effort to lay out the source surfaces correctly because GDI rearranges the sources in an undefined manner to enforce the layout rules. The resultant layout may not be what the caller wanted to achieve.

Requirements

Version

Available in Windows 7 Client.

Header

Wingdi.h (include Windows.h)

See also

DISPLAYCONFIG_PIXELFORMAT
POINTL
SetDisplayConfig

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft