EVT_IDD_CX_ADAPTER_COMMIT_MODES callback function

EVT_IDD_CX_ADAPTER_COMMIT_MODES is called by the OS 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

A handle provided by the driver used by the OS to reference the adapter in a call to the driver.

pInArgs

Input arguments used by EVT_IDD_CX_ADAPTER_COMMIT_MODES.

Return Value

(NTSTATUS) If the operation is successful, the callback function must return STATUS_SUCCESS, or another status value for which NT_SUCCESS(status) equals TRUE. Otherwise, an appropriate NTSTATUS error code.

Remarks

The OS always provides the IDDCX_PATH for every connected monitor even if it is not 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.

Note  

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

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