EVT_IDD_CX_MONITOR_SET_GAMMA_RAMP callback function (iddcx.h)

The operating system calls EVT_IDD_CX_MONITOR_SET_GAMMA_RAMP to set a gamma ramp on the specified monitor.

Syntax

EVT_IDD_CX_MONITOR_SET_GAMMA_RAMP EvtIddCxMonitorSetGammaRamp;

NTSTATUS EvtIddCxMonitorSetGammaRamp(
  [in] IDDCX_MONITOR MonitorObject,
  [in] const IDARG_IN_SET_GAMMARAMP *pInArgs
)
{...}

Parameters

[in] MonitorObject

An IDDCX_MONITOR object which is the OS's context handle that identifies the monitor to set a gamma ramp for.

[in] pInArgs

An IDARG_IN_SET_GAMMARAMP structure containing information about the gamma ramp being set.

Return value

EVT_IDD_CX_MONITOR_SET_GAMMA_RAMP returns an NTSTATUS value. If the operation is successful, it returns STATUS_SUCCESS or another status value for which NT_SUCCESS(status) equals TRUE. Otherwise, it returns an appropriate NTSTATUS error code.

Remarks

If a driver reports FP16 support for an adapter it must also accept and use IDDCX_GAMMARAMP_TYPE_3x4_COLORSPACE_TRANSFORM regardless of gamma support previously reported in a call to IddCxAdapterInitAsync. This type of gamma ramp can be sent for any monitor even if HDR is not currently being used.

It's possible that some parts of the transform won't be required or have no effect. In this case, the OS will set the appropriate flag to FALSE allowing the driver to potentially use an optimized transform. Like other gamma ramps, the 3x4 transform must also be applied to mouse cursors.

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

Requirements

Requirement Value
Minimum supported client Windows 10
Minimum supported server Windows Server 2016
Target Platform Windows
Header iddcx.h
IRQL requires_same

See also

IDARG_IN_SET_GAMMARAMP

IDDCX_GAMMARAMP_TYPE_3x4_COLORSPACE_TRANSFORM