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 |