DXGKDDI_DISPLAYMUX_PRE_SWITCH_TO callback function (dispmprt.h)

Dxgkrnl calls the kernel-mode display driver's (KMD) DxgkddiDisplayMuxPreSwitchTo function to notify the driver currently not connected to the display that the display is about to be switched to its GPU.

Syntax

DXGKDDI_DISPLAYMUX_PRE_SWITCH_TO DxgkddiDisplaymuxPreSwitchTo;

NTSTATUS DxgkddiDisplaymuxPreSwitchTo(
  PVOID DriverContext,
  ULONG VidPnTargetId,
  ULONG CurrentBrightnessLevel
)
{...}

Parameters

DriverContext

[in] Handle to a context block that is associated with a display adapter. KMD's DxgkDdiAddDevice function previously provided this handle to Dxgkrnl.

VidPnTargetId

[in] The VidPN target that the DDI is being called for.

CurrentBrightnessLevel

[in] The current brightness level for the panel.

Return value

DxgkddiDisplayMuxPreSwitchTo returns STATUS_SUCCESS if it succeeds. Otherwise, it returns an appropriate NT_STATUS error code.

Remarks

This DDI is called under synchronization level 2.

For more information, see Automatic Display Switch.

Requirements

Requirement Value
Minimum supported client Windows 11, version 24H2, update 2025.01
Header dispmprt.h
IRQL PASSIVE_LEVEL

See also

DxgkddiDisplayMuxPreSwitchAway