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

See also

IDARG_IN_COMMITMODES