DigitalWindowControl Class

Reference

Definition

Namespace:: Windows.Media.Devices

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Edit

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)	Configures the DigitalWindowControl to use the specified mode.
Configure(DigitalWindowMode, DigitalWindowBounds)	Configures the DigitalWindowControl to use the specified mode and bounds.
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.

Applies to