Windows desktop applications
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

VideoDeviceController class

Controls device settings on the camera.

Syntax


public ref class VideoDeviceController sealed : IMediaDeviceController

Members

The VideoDeviceController class has these types of members:

Methods

The VideoDeviceController class has these methods. With C#, Visual Basic, and C++, it also inherits methods from the Object class.

MethodDescription
GetAvailableMediaStreamProperties Gets a list of the supported encoding properties for the video device.
GetDeviceProperty Gets a property on the camera.
GetMediaStreamProperties Gets the encoding properties for the specified media stream type for the video device.
SetDeviceProperty Sets a property on the device.
SetMediaStreamPropertiesAsync Sets the encoding properties asynchronously for the specified media stream type for the video device.
TryGetPowerlineFrequency Gets the local power line frequency.
TrySetPowerlineFrequency Sets the local power line frequency.

 

Properties

The VideoDeviceController class has these properties.

PropertyAccess typeDescription

AdvancedPhotoControl

Read-only

Gets the advanced photo capture control for this video device.

BacklightCompensation

Read-only

Specifies whether back-light compensation is enabled on the camera.

Brightness

Read-only

Gets or sets the brightness level on the camera.

Contrast

Read-only

Gets or sets the contrast level on the camera.

DesiredOptimization

Read/write

Gets or sets a value that indicates the optimizations the capture device should use to prioritize high quality picture, low latency, or low power consumption during video capture.

Exposure

Read-only

Gets or sets the camera's exposure time.

ExposureCompensationControl

Read-only

Gets the exposure compensation control for this video device.

ExposureControl

Read-only

Gets the exposure control for this video device.

ExposurePriorityVideoControl

Read-only

Gets the ExposurePriorityVideoControl associated with the VideoDeviceController.

FlashControl

Read-only

Gets the flash control for this video device.

Focus

Read-only

Gets or sets the camera's focus setting.

FocusControl

Read-only

Gets the focus control for this video device.

HdrVideoControl

Read-only

Gets the HdrVideoControl associated with the VideoDeviceController.

Hue

Read-only

Gets or sets the camera's hue setting.

IsoSpeedControl

Read-only

Gets the ISO film speed control for this video device.

LowLagPhoto

Read-only

Gets the low shutter lag photo control for this video device.

LowLagPhotoSequence

Read-only

Gets the low shutter lag photo sequence control for this video device.

OpticalImageStabilizationControl

Read-only

Gets the OpticalImageStabilizationControl associated with the VideoDeviceController.

Pan

Read-only

Gets or sets the camera's pan setting.

PhotoConfirmationControl

Read-only

Gets the photo confirmation control for this video device.

PrimaryUse

Read/write

Gets or sets the primary use for the device.

RegionsOfInterestControl

Read-only

Gets the regions of interest control for this video device.

Roll

Read-only

Gets or sets the camera's roll setting.

SceneModeControl

Read-only

Gets the scene mode control for this video device.

Tilt

Read-only

Gets or sets the camera's tilt setting.

TorchControl

Read-only

Gets the torch control for this video device.

VariablePhotoSequenceController

Read-only

Gets the VariablePhotoSequenceController associated with the VideoDeviceController.

WhiteBalance

Read-only

Gets or sets the white balance on the camera.

WhiteBalanceControl

Read-only

Gets the white balance control for this video device.

Zoom

Read-only

Gets and sets the camera's zoom setting.

ZoomControl

Read-only

Gets the ZoomControl associated with the VideoDeviceController.

 

Remarks

To get an instance of this object, retrieve the MediaCapture.VideoDeviceController property.

Some drivers may require that the camera device preview to be in a running state before it can determine which controls are supported by the VideoDeviceController. If you check whether a certain control is supported by the VideoDeviceController before the preview stream is running, the control may be described as unsupported even though it is supported by the video device.

Note  : This class is not agile, which means that you need to consider its threading model and marshaling behavior. For more info, see Threading and Marshaling (C++/CX) and Using Windows Runtime objects in a multithreaded environment (.NET).
 

Examples

The following example shows how to get an instance of this object.


function createVideoDevice() {
    var videoDev = null;
    var mediaDev = null;
    mediaDev = new Windows.Media.Capture.MediaCapture();
    videoDev = mediaDev.videoDeviceController;
}


Requirements (Windows 10 device family)

Device family

Universal, introduced version 10.0.10240.0

API contract

Windows.Foundation.UniversalApiContract, introduced version 1.0

Namespace

Windows.Media.Devices
Windows::Media::Devices [C++]

Metadata

Windows.Foundation.UniversalApiContract.winmd

Requirements (Windows 8.x and Windows Phone 8.x)

Minimum supported client

Windows 8 [Windows Store apps, desktop apps]

Minimum supported server

Windows Server 2012 [Windows Store apps, desktop apps]

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]

Namespace

Windows.Media.Devices
Windows::Media::Devices [C++]

Metadata

Windows.winmd

Attributes

[DualApiPartition()]
[MarshalingBehavior(Standard)]
[Threading(MTA)]
[Version(0x06020000)]

See also

Object
IMediaDeviceController

 

 

Show:
© 2016 Microsoft