EVT_IDD_CX_ADAPTER_COMMIT_MODES callback function (iddcx.h)
The OS calls EVT_IDD_CX_ADAPTER_COMMIT_MODES to inform the driver of a mode change for monitors on the adapter.
Syntax
EVT_IDD_CX_ADAPTER_COMMIT_MODES EvtIddCxAdapterCommitModes;
NTSTATUS EvtIddCxAdapterCommitModes(
IDDCX_ADAPTER AdapterObject,
const IDARG_IN_COMMITMODES *pInArgs
)
{...}
Parameters
AdapterObject
[in] A driver-provided IDDCX_ADAPTER handle that is used by the OS to reference the adapter in a call to the driver.
pInArgs
[in] Pointer to a IDARG_IN_COMMITMODES structure that contains arguments used by EVT_IDD_CX_ADAPTER_COMMIT_MODES.
Return value
EVT_IDD_CX_ADAPTER_COMMIT_MODES 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
The OS always provides the IDDCX_PATH for every connected monitor even if that monitor isn't active, and indicates which paths have changed. If a path is marked inactive, then the whole display pipeline for that path will be powered off and no signal will be sent to the monitor.
When a new path is committed, the driver should program the display pipeline to display a black image until the first frame is ready to be displayed. To achieve this, WDDM visibility should be off until the first frame is ready to be displayed, then the visibility should be turned on.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 10 |
| Minimum supported server | Windows Server 2016 |
| Target Platform | Windows |
| Header | iddcx.h |
| IRQL | requires_same |