DigitalWindowControl Class

Definition

Namespace:

Windows.Media.Devices

Allows apps to capture a subregion of the capture device's sensor. For cameras that offer high-resolution native sensors, this feature enables digital pan, tilt, and zoom and allow apps to obtain higher detail images of such objects without the need to change media resolutions.

public ref class DigitalWindowControl sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 786432)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DigitalWindowControl final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 786432)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DigitalWindowControl

Public NotInheritable Class DigitalWindowControl

Inheritance

Object Platform::Object IInspectable DigitalWindowControl

Attributes

ContractVersionAttribute MarshalingBehaviorAttribute

Windows requirements

Device family	Windows 10, version 2104 (introduced in 10.0.20348.0)
API contract	Windows.Foundation.UniversalApiContract (introduced in v12.0)

Remarks

Access the DigitalWindowControl for the capture device by accessing the MediaCapture.VideoDeviceController property and then the VideoDeviceController.DigitalWindowControl property. Determine if the controls is supported by the capture device by checking DigitalWindowControl.IsSupported.

For more information on using the DigitalWindowControl in your app, see Manual camera controls for photo and video capture.

Properties

CurrentMode	Gets a value from the DigitalWindowMode enumeration specifying the current mode of the DigitalWindowControl.
IsSupported	Gets a boolean value that indicates whether DigitalWindowControl is supported on the capture device.
SupportedCapabilities	Gets a read-only list of DigitalWindowCapability objects describing the capabilities of the capture device.
SupportedModes	Gets an array of values from the DigitalWindowMode enumeration indicating the modes supported by the capture device.

Methods

Configure(DigitalWindowMode, DigitalWindowBounds)	Configures the DigitalWindowControl to use the specified mode and bounds.
Configure(DigitalWindowMode)	Configures the DigitalWindowControl to use the specified mode.
GetBounds()	Gets a DigitalWindowBounds object representing the bounds of the current digital window.
GetCapabilityForSize(Int32, Int32)	Gets a DigitalWindowCapability object that specifies the digital window capabilities of the capture device for the specified capture resolution.

See also

• Manual camera controls for photo and video capture