Edit

IDDCX_DISPLAYCONFIGPATH2 structure (iddcx.h)

  • Article

A IDDCX_DISPLAYCONFIGPATH2 structure contains path display configuration information.

Syntax

struct IDDCX_DISPLAYCONFIGPATH2 {
  UINT                                    Size;
  IDDCX_DISPLAYCONFIGPATH2_FLAGS          Flags;
  IDDCX_MONITOR                           MonitorObject;
  IDDCX_DISPLAYCONFIG_MODE                Mode;
  UINT                                    MonitorScaleFactor;
  DISPLAYCONFIG_2DREGION                  MonitorPhysicalSize;
  IDDCX_DISPLAYCONFIG_MONITOR_COLORIMETRY MonitorColorimetry;
  UINT                                    MonitorSdrWhiteLevel;
};

Members

Size

Size, in bytes, of this structure.

Flags

A bitwise OR of IDDCX_DISPLAYCONFIGPATH2_FLAGS values that identify the flags for this path, including which fields contain valid data.

MonitorObject

An IDDCX_MONITOR object handle that the driver provides to identify the monitor this path is targeted at.

Mode

If valid, this field is a IDDCX_DISPLAYCONFIG_MODE structure that contains details of the mode to be set for the monitor in this path.

MonitorScaleFactor

If valid, this field specifies the requested monitor DPI for this path. This value is just a hint and OS may override it to ensure the DPI configuration of the session is valid. Valid values are 100 to 500 inclusive.

MonitorPhysicalSize

If valid, this field is a DISPLAYCONFIG_2DREGION structure that contains the physical width and height override for the specified monitor, in millimeters. A value of zero means no override.

MonitorColorimetry

If valid, this field is a IDDCX_DISPLAYCONFIG_MONITOR_COLORIMETRY structure that contains the colorimetry details for the specified monitor.

MonitorSdrWhiteLevel

If valid, this field specifies the new white level, in nits, to be used for SDR content on this monitor when in an HDR mode.

Remarks

An indirect display driver (IDD) calls IddCxAdapterDisplayConfigUpdate2 when it receives a new display configuration. It passes an array of IDDCX_DISPLAYCONFIGPATH2 structures in IDARG_IN_ADAPTERDISPLAYCONFIGUPDATE2.

For more information about HDR support, see IddCx version 1.10 updates.

Requirements

Requirement Value
Minimum supported client Windows 11, version 22H2 September Update (IddCx version 1.10)
Header iddcx.h

See also

IDARG_IN_ADAPTERDISPLAYCONFIGUPDATE2

IddCxAdapterDisplayConfigUpdate2