Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

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

DXGI1_6.h

See also

DXGI Structures

 

 

Show:
© 2017 Microsoft