Share via

ExposureControl Class

  • Reference

Definition

Namespace:
Windows.Media.Devices
Edit

Provides functionality for controlling the exposure settings on a capture device.

public ref class ExposureControl sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
class ExposureControl final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
public sealed class ExposureControl
Public NotInheritable Class ExposureControl
Inheritance
Object Platform::Object IInspectable ExposureControl
Attributes
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows requirements

Device family
Windows 10 (introduced in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v1.0)

Remarks

The ExposureControl gives apps additional control over the exposure settings on a device.

To set an exposure value, call SetValueAsync. To turn auto exposure on, call SetAutoAsync.

You can find out if a device supports this control by checking ExposureControl.Supported.

If the device does not support the ExposureControl, you can still use the Exposure property on the VideoCaptureDevice to set the exposure value.

You can access the ExposureControl for the capture device through MediaCapture.VideoDeviceController.

For how-to guidance for using the ExposureControl, see Manual camera controls for photo and video capture.

Properties

Auto

Gets a value that indicates if auto exposure is enabled.
Max

The maximum EV compensation supported.
Min

Gets the minimum EV compensation supported.
Step

Gets the smallest exposure time increment supported by the capture device.
Supported

Gets a value that specifies if the capture device supports the exposure control.
Value

Gets the EV compensation value.

Methods

SetAutoAsync(Boolean)

Asynchronously enables or disable auto exposure.
SetValueAsync(TimeSpan)

Asynchronously sets the exposure time.

Applies to

See also