DXGK_BRIGHTNESS_SET_BACKLIGHT_OPTIMIZATION callback function (dispmprt.h)

Called by the Microsoft DirectX graphics kernel subsystem to set the level of optimization that the display miniport driver uses to control the brightness of an integrated display panel.

Syntax

DXGK_BRIGHTNESS_SET_BACKLIGHT_OPTIMIZATION DxgkBrightnessSetBacklightOptimization;

NTSTATUS DxgkBrightnessSetBacklightOptimization(
  [in] PVOID Context,
  [in] DXGK_BACKLIGHT_OPTIMIZATION_LEVEL OptimizationLevel
)
{...}

Parameters

[in] Context

A handle to a context block that is associated with a display adapter. The display miniport driver's DxgkDdiAddDevice function previously provided this handle to the DirectX graphics kernel subsystem.

[in] OptimizationLevel

A value of type DXGK_BACKLIGHT_OPTIMIZATION_LEVEL that indicates the optimization level of brightness control.

Return value

Returns STATUS_SUCCESS if it succeeds. Otherwise, it returns one of the error codes that are defined in Ntstatus.h.

Remarks

The display miniport driver can dynamically change the backlight optimization level of the integrated display panel based upon the current content on the screen.

The driver must respond to requests from the operating system to change the backlight optimization level in the OptimizationLevel parameter. Such requests are based upon system state changes.

After the driver has enabled adaptive brightness on the display panel in response to a call to the DxgkDdiSetBrightnessState function, it must not disable adaptive brightness.

When the driver transitions from one backlight optimization level to another, it should make a gradual transition in brightness settings of the integrated display panel. An important example of this type of transition is when a user adjusts video playback controls and the operating system responds by resetting the value of OptimizationLevel from DxgkBacklightOptimizationDynamic to DxgkBacklightOptimizationDesktop.

Connecting additional display devices to the system must not compromise the ability of the driver to perform adaptive brightness control on the integrated display panel.

This function should be made pageable.

Requirements

Requirement Value
Minimum supported client Windows 8
Minimum supported server Windows Server 2012
Target Platform Desktop
Header dispmprt.h (include Dispmprt.h)
IRQL PASSIVE_LEVEL

See also

DXGK_BACKLIGHT_OPTIMIZATION_LEVEL

DxgkDdiAddDevice

DxgkDdiSetBrightnessState