Expand Minimize

DXGK_BACKLIGHT_OPTIMIZATION_LEVEL enumeration

Indicates the optimization level of brightness control. Used by Windows Display Driver Model (WDDM) 1.2 and later display miniport drivers that support adaptive brightness control.

Syntax


typedef enum  { 
  DxgkBacklightOptimizationDisable  = 0,
  DxgkBacklightOptimizationDesktop  = 1,
  DxgkBacklightOptimizationDynamic  = 2,
  DxgkBacklightOptimizationDimmed   = 3
} DXGK_BACKLIGHT_OPTIMIZATION_LEVEL;

Constants

DxgkBacklightOptimizationDisable

The display miniport driver must completely disable adaptive brightness control.

The operating system always sets this value if the system is on AC power.

DxgkBacklightOptimizationDesktop

The display miniport driver should optimize backlight settings for desktop presentation when the system is on DC power and the other possible scenarios (disabled, dynamic, and dimmed) are not active. This type of optimization is appropriate for displaying photos, internet browsers, common document types, and video playback controls.

This is the default adaptive brightness setting when the system is on DC power.

DxgkBacklightOptimizationDynamic

The display miniport driver should optimize backlight settings for presentation of full-screen video. Typical playback scenarios include playing movies and full-screen video.

The operating system sets this value if a full-screen Windows Store app is using the HTML5 video tag with JavaScript or the MediaElement control with XAML.

The operating system sets this value only when only full-screen video content is displayed on the screen. This value is not set if playback controls or charms are displayed during video playback; in this case, adaptive brightness will not be enabled.

DxgkBacklightOptimizationDimmed

The display miniport driver should optimize backlight settings to display at a low light level that is still visible even if it is not easily readable. In this scenario the display is typically set to a 30 percent brightness level.

After a defined period of no user input, the operating system sets this value to dim the display.

Remarks

For more information on usage scenarios involving DXGK_BACKLIGHT_OPTIMIZATION_LEVEL enumeration values, see Remarks in the DxgkDdiSetBacklightOptimization function.

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Header

D3dkmdt.h (include D3dkmdt.h)

See also

DxgkDdiSetBacklightOptimization

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft