DISPLAYCONFIG_SOURCE_MODE structure (wingdi.h)
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
| Requirement | Value |
|---|---|
| Minimum supported client | Available in Windows 7 Client. |
| Header | wingdi.h (include Windows.h) |