Edit

Share via

IDDCX_MONITOR_DESCRIPTION structure (iddcx.h)

Important

Some information relates to a prerelease product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

A IDDCX_MONITOR_DESCRIPTION structure provides a monitor description.

Syntax

struct IDDCX_MONITOR_DESCRIPTION {
  UINT                           Size;
  IDDCX_MONITOR_DESCRIPTION_TYPE Type;
  UINT                           DataSize;
  PVOID                          pData;
};

Members

Size

Total size of the structure, in bytes.

Type

A IDDCX_MONITOR_DESCRIPTION_TYPE value that describes the monitor's type.

DataSize

The size in bytes of the monitor description data that pData points to.

pData

Pointer to the monitor description data. The data layout depends on Type as follows:

  • If Type is IDDCX_MONITOR_DESCRIPTION_TYPE_EDID:
    • If DataSize > 0 and pData != NULL, pData points to an EDID data formatted monitor description.
    • If DataSize = 0 and pData = NULL, no monitor description is available.
  • If Type is IDDCX_MONITOR_DESCRIPTION_TYPE_DISPLAYID_AND_EDID, the monitor description starts with a DisplayID description followed by EDID without any padding in between. The EDID format should contain all available data blocks and be present. The call to connect the monitor will fail if DisplayID is missing or invalid, or if EDID is missing.
  • If Type is IDDCX_MONITOR_DESCRIPTION_TYPE_DISPLAYID, the monitor description data only contains a DisplayID descriptor. This type can be set by a driver when calling IddCxMonitorCreate. It can also be set by the OS when calling EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION, EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION2, EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES, or EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2.

Remarks

In order to support displays that only contain a DisplayID descriptor the IDDCX_MONITOR_DESCRIPTION structure has been updated. Specifically, a new IDDCX_MONITOR_DESCRIPTION_TYPE has been added to the IDDCX_MONITOR_DESCRIPTION_TYPE enumeration.

Drivers must check for OS support for this functionality, that is, ensure IDDCX_DEVICE_FEATURES_1_11_DISPLAY_ID_ONLY is set in the data returned from a call to IddCxCheckOsFeatureSupport. If the OS doesn't support this functionality, either because it doesn't support IddCx 1.11 or it supports 1.11 but the feature support isn't present, then sending DisplayID only descriptors is an error.

Note

The IDDCX_MONITOR_DESCRIPTION::pData field isn't new, but the summary comments have been updated to reflect the new functionality.

Requirements

Requirement Value
Minimum supported client Windows 11, 26H1 (IddCx 1.11)
Header iddcx.h

See also

EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION

IddCxMonitorCreate

  • Last updated on