EVT_IDD_CX_ADAPTER_COMMIT_MODES - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// iddcx.h

EVT_IDD_CX_ADAPTER_COMMIT_MODES EvtIddCxAdapterCommitModes;

NTSTATUS EvtIddCxAdapterCommitModes(
  IDDCX_ADAPTER AdapterObject,
  const IDARG_IN_COMMITMODES *pInArgs
)
{...}
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (nc-iddcx-evt_idd_cx_adapter_commit_modes)

EVT_IDD_CX_ADAPTER_COMMIT_MODES callback function

Description

The OS calls EVT_IDD_CX_ADAPTER_COMMIT_MODES to inform the driver of a mode change for monitors on the adapter.

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.

See also

IDARG_IN_COMMITMODES