| Previous | Next |
| ERROR_MCA_INVALID_TECHNOLOGY_TYPE_RETURNED | ERROR_AMBIGUOUS_SYSTEM_DEVICE |
ERROR_MCA_UNSUPPORTED_COLOR_TEMPERATURE
This is a hardware-control failure
ERROR_MCA_UNSUPPORTED_COLOR_TEMPERATURE is returned in the Monitor Configuration API path when SetMonitorColorTemperature is asked to use a preset that the current physical monitor does not support. It concerns DDC/CI and MCCS monitor controls, not an ICC profile, Windows Night light, application color management, or a GPU color transform.
Ask the monitor before requesting a preset
The intended sequence is to call GetMonitorCapabilities for the physical monitor handle and examine both its capability flags and the supported-color-temperature mask. Only then should an application call SetMonitorColorTemperature with one of the documented presets. A missing capability is different from a valid capability whose accepted preset set is smaller than the application expected.
Common diagnostic mistakes
- Using an
HMONITORas though it were already a physical monitor handle. - Assuming that an OSD color mode maps directly to an MCCS temperature preset.
- Testing a preset through a docked or switched path and treating a video-successful connection as proof that the DDC/CI control path is available.
- Retrying the same unsupported write repeatedly instead of recording the supported mask and choosing a supported operation.
Do not work around this by sending arbitrary VCP writes. Microsoft cautions that many displays do not fully implement MCCS, so a command that is accepted by one monitor can have undefined behavior on another.
References
- Microsoft: GetMonitorCapabilities
- Microsoft: color-temperature and monitor-control functions
- Microsoft: ERROR_MCA_UNSUPPORTED_COLOR_TEMPERATURE
- ddcutil: MCCS VCP feature model
Looking for a different code? Search another status or error code.