Edit

Share via

IddCxMonitorUpdateModes2 function (iddcx.h)

  • Article

An indirect display driver calls IddCxMonitorUpdateModes2 to have the OS update the mode list for a monitor.

Syntax

NTSTATUS IddCxMonitorUpdateModes2(
  IDDCX_MONITOR               MonitorObject,
  const IDARG_IN_UPDATEMODES2 *pInArgs
);

Parameters

MonitorObject

[in] An IDDCX_MONITOR object that is the OS's context handle for the monitor. The OS provided this handle in a prior call to IddCxMonitorCreate.

pInArgs

[in] Pointer to an IDARG_IN_UPDATEMODES2 structure that contains the input arguments for this function.

Return value

IddCxMonitorUpdateModes2 returns STATUS_SUCCESS upon success; otherwise it returns an appropriate NTSTATUS error code.

Remarks

A driver can call IddCxMonitorUpdateModes2 to update the mode list previously reported for a monitor.

Drivers sending modes with SDR WCG or HDR parameters will fail if they have not also reported IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 in the IddCxAdapterInitAsync call. Also, drivers reporting IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 can only call IddCxMonitorUpdateModes2; calling IddCxMonitorUpdateModes is an error.

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_UPDATEMODES2