Edit

DXGI_OUTPUT_DESC1 structure (dxgi1_6.h)

  • Article

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;
  FLOAT                 MaxFullFrameLuminance;
} DXGI_OUTPUT_DESC1;

Members

DeviceName[32]

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[2]

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[2]

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[2]

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[2]

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: FLOAT

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.

Remarks

The DXGI_OUTPUT_DESC1 structure is initialized by the IDXGIOutput6::GetDesc1 method.

Requirements

Requirement Value
Header dxgi1_6.h

See also

DXGI Structures