DXGKDDI_DISPLAYMUX_GET_RUNTIME_STATUS callback function (dispmprt.h)
Dxgkrnl calls the kernel-mode display driver's (KMD) DxgkDdiDisplayMuxGetRuntimeStatus function to query the runtime level of automatic display switch (ADS) support that the driver provides.
Syntax
DXGKDDI_DISPLAYMUX_GET_RUNTIME_STATUS DxgkddiDisplaymuxGetRuntimeStatus;
NTSTATUS DxgkddiDisplaymuxGetRuntimeStatus(
PVOID DriverContext,
PDXGK_DISPLAYMUX_RUNTIME_STATUS pRuntimeStatus
)
{...}
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.
pRuntimeStatus
[out] Pointer to a DXGK_DISPLAYMUX_RUNTIME_STATUS value in which the driver writes the runtime status of ADS support that it provides.
Return value
DxgkDdiDisplayMuxGetRuntimeStatus returns STATUS_SUCCESS if it succeeds. Otherwise, it returns an appropriate NT_STATUS error code.
Remarks
This DDI is called under synchronization level 2.
DxgkDdiDisplayMuxGetRuntimeStatus is called after DxgkDdiStartDevice. It allows KMD to indicate that it can't support ADS on this system for some reason. The driver shouldn't attempt to query information about other GPUs in the system or communicate with the ACPI mux device.
If the driver sets pRuntimeStatus to point to DXGK_DISPLAYMUX_RUNTIME_STATUS_NON_CRITICAL_SYSTEM_INFO_MISSING, the system will enable ADS for developmental purposes only; that is, ADS will not be enabled for customer use.
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 |