Share via


Microsoft-Windows-Devices-Lights-Configuration

The Microsoft-Windows-Devices-Lights-Configuration component specifies settings for the keyboard backlight.

In this section

Setting Description
BacklightAutobrightnessBucketMapping Lookup table for keyboard backlight auto-brightness that maps ambient light reading ranges (in lux) to a percentage bucket.
BacklightAutobrightnessManualOverrideLut Lookup table that specifies lower and upper thresholds for applying a temporary manual override of keyboard backlight auto-brightness, expressed as a percentage of the current ambient light reading.
BacklightEnergySaverEnabled Defines whether the keyboard backlight should be dimmed when the system is in Energy Saver mode.
BacklightEnergySaverMultiplier Indicates by what brightness percentage the keyboard backlight should be dimmed when the system is in Energy Saver mode.
EnableBucketedBacklightAutobrightness Defines whether bucketized keyboard backlight auto-brightness is enabled.

XML examples

The following unattend XML example shows how you can specify default parameters for keyboard backlight behavior.

<?xml version="1.0" encoding="UTF-8"?>
<unattend xmlns="urn:schemas-microsoft-com:unattend">
   <settings pass="offlineServicing">
      <component language="neutral" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:wcm="http://schemas.microsoft.com/WMIConfig/2002/State" versionScope="nonSxS" publicKeyToken="31bf3856ad364e35" processorArchitecture="amd64" name="Microsoft-Windows-Devices-Lights-Configuration">
         <BacklightAutobrightnessBucketMapping>0:50:100,25.5:85:80,70:150.5:60,140:500:40,480:1000:20,950:3000:0</BacklightAutobrightnessBucketMapping>
         <BacklightAutobrightnessManualOverrideLut>0:10:1.0:0.5,10:50:0.45:0.4,50:145:0.3:0.25,145:1000:0.2:0.15,1000:10000:0.1:0.1</BacklightAutobrightnessManualOverrideLut>
         <BacklightEnergySaverEnabled>true</BacklightEnergySaverEnabled>
         <BacklightEnergySaverMultiplier>65</BacklightEnergySaverMultiplier>
         <EnableBucketedBacklightAutobrightness>true</EnableBucketedBacklightAutobrightness>
      </component>
   </settings>
</unattend>

Applies To

To determine whether a component applies to the image you’re building, load your image into Windows SIM and search for the component or setting name. For information on how to view components and settings, see Configure Components and Settings in an Answer File.

Components

Ambient light response curve changes for Windows 11