Share via


WhiteBalanceControl.SetValueAsync(UInt32) Method

Definition

Asynchronously sets the color temperature Value.

public:
 virtual IAsyncAction ^ SetValueAsync(unsigned int temperature) = SetValueAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction SetValueAsync(uint32_t const& temperature);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction SetValueAsync(uint temperature);
function setValueAsync(temperature)
Public Function SetValueAsync (temperature As UInteger) As IAsyncAction

Parameters

temperature
UInt32

unsigned int

uint32_t

The temperature value to set the Value property to.

Returns

The object that is used to control the asynchronous operation.

Attributes

Remarks

White balance is specified as a color temperature in degrees Kelvin.

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.

Applies to