DXGI_OUTPUT_DESC1 structure
Describes an output or physical connection between the adapter (video card) and a device, including additional information about color capabilities and connection type.
Syntax
typedef struct DXGI_OUTPUT_DESC1 { WCHAR DeviceName[32]; RECT DesktopCoordinates; BOOL AttachedToDesktop; DXGI_MODE_ROTATION Rotation; HMONITOR Monitor; UINT BitsPerColor; DXGI_COLOR_SPACE_TYPE ColorSpace; FLOAT RedPrimary[2]; FLOAT GreenPrimary[2]; FLOAT BluePrimary[2]; FLOAT WhitePoint[2]; FLOAT MinLuminance; FLOAT MaxLuminance; FLAOT MaxFullFrameLuminance; BOOL InternalOutput; } DXGI_OUTPUT_DESC1;
Members
- DeviceName
-
Type: WCHAR[32]
-
A string that contains the name of the output device.
- DesktopCoordinates
-
Type: RECT
-
A RECT structure containing the bounds of the output in desktop coordinates. Desktop coordinates depend on the dots per inch (DPI) of the desktop. For info about writing DPI-aware Win32 apps, see High DPI.
- AttachedToDesktop
-
Type: BOOL
-
True if the output is attached to the desktop; otherwise, false.
- Rotation
-
Type: DXGI_MODE_ROTATION
-
A member of the DXGI_MODE_ROTATION enumerated type describing on how an image is rotated by the output.
- Monitor
-
Type: HMONITOR
-
An HMONITOR handle that represents the display monitor. For more information, see HMONITOR and the Device Context.
- BitsPerColor
-
Type: UINT
-
The number of bits per color channel for the active wire format of the display attached to this output.
- ColorSpace
-
Type: DXGI_COLOR_SPACE_TYPE
-
The current advanced color capabilities of the display attached to this output. Specifically, whether its capable of reproducing color and luminance values outside of the sRGB color space. A value of DXGI_COLOR_SPACE_RGB_FULL_G22_NONE_P709 indicates that the display is limited to SDR/sRGB; A value of DXGI_COLOR_SPACE_RGB_FULL_G2048_NONE_P2020 indicates that the display supports advanced color capabilities.
For detailed luminance and color capabilities, see additional members of this struct.
- RedPrimary
-
Type: FLOAT[2]
-
The red color primary, in xy coordinates, of the display attached to this output. This value will usually come from the EDID of the corresponding display or sometimes from an override.
- GreenPrimary
-
Type: FLOAT[2]
-
The green color primary, in xy coordinates, of the display attached to this output. This value will usually come from the EDID of the corresponding display or sometimes from an override.
- BluePrimary
-
Type: FLOAT[2]
-
The blue color primary, in xy coordinates, of the display attached to this output. This value will usually come from the EDID of the corresponding display or sometimes from an override.
- WhitePoint
-
Type: FLOAT[2]
-
The white point, in xy coordinates, of the display attached to this output. This value will usually come from the EDID of the corresponding display or sometimes from an override.
- MinLuminance
-
Type: FLOAT
-
The minimum luminance, in nits, that the display attached to this output is capable of rendering. Content should not exceed this minimum value for optimal rendering. This value will usually come from the EDID of the corresponding display or sometimes from an override.
- MaxLuminance
-
Type: FLOAT
-
The maximum luminance, in nits, that the display attached to this output is capable of rendering; this value is likely only valid for a small area of the panel. Content should not exceed this minimum value for optimal rendering. This value will usually come from the EDID of the corresponding display or sometimes from an override.
- MaxFullFrameLuminance
-
Type: FLAOT
-
The maximum luminance, in nits, that the display attached to this output is capable of rendering; unlike MaxLuminance, this value is valid for a color that fills the entire area of the panel. Content should not exceed this value across the entire panel for optimal rendering. This value will usually come from the EDID of the corresponding display or sometimes from an override.
- InternalOutput
-
Type: BOOL
-
True if this output is attached to an internal/integrated display panel; otherwise, false.
Remarks
The DXGI_OUTPUT_DESC1 structure is initialized by the IDXGIOutput6::GetDesc1 method.
Requirements
|
Header |
|
|---|
See also