-api-id | -api-type |
---|---|
M:Windows.Media.Devices.WhiteBalanceControl.SetPresetAsync(Windows.Media.Devices.ColorTemperaturePreset) |
winrt method |
Asynchronously sets the color temperature Preset.
The color temperate preset to set the Preset property to.
The object that is used to control the asynchronous operation.
Adjusting the white balance is only supported while the preview stream is running. Check to make sure that the preview stream is running before setting the white balance value or preset.
The ColorTemperaturePreset.Auto preset value instructs the system to automatically adjust the white balance level. For some scenarios, such as capturing a photo sequence where the white balance levels should be the same for each frame, you may want to lock the control to the current automatic value. To do this, call SetPresetAsync and specify the Manual preset and do not set a value on the control using SetValueAsync. This will cause the device to lock the current value. Do not attempt to read the current control value and then pass the returned value into SetValueAsync because this value is not guaranteed to be correct.