VideoDeviceController.SetMediaStreamPropertiesAsync(MediaStreamType, IMediaEncodingProperties) VideoDeviceController.SetMediaStreamPropertiesAsync(MediaStreamType, IMediaEncodingProperties) VideoDeviceController.SetMediaStreamPropertiesAsync(MediaStreamType, IMediaEncodingProperties) VideoDeviceController.SetMediaStreamPropertiesAsync(MediaStreamType, IMediaEncodingProperties) VideoDeviceController.SetMediaStreamPropertiesAsync(MediaStreamType, IMediaEncodingProperties) Method

Definition

Sets the encoding properties asynchronously for the specified media stream type for the video device.

public : IAsyncAction SetMediaStreamPropertiesAsync(MediaStreamType mediaStreamType, IMediaEncodingProperties mediaEncodingProperties)
IAsyncAction SetMediaStreamPropertiesAsync(MediaStreamType mediaStreamType, IMediaEncodingProperties mediaEncodingProperties) const;
public IAsyncAction SetMediaStreamPropertiesAsync(MediaStreamType mediaStreamType, IMediaEncodingProperties mediaEncodingProperties)
Public Function SetMediaStreamPropertiesAsync(mediaStreamType As MediaStreamType, mediaEncodingProperties As IMediaEncodingProperties) As IAsyncAction
Windows.Media.Devices.VideoDeviceController.setMediaStreamPropertiesAsync(mediaStreamType, mediaEncodingProperties).done( /* Your success and error handlers */ );

Parameters

mediaStreamType
MediaStreamType MediaStreamType MediaStreamType

The type of media stream for which to set the properties.

mediaEncodingProperties
IMediaEncodingProperties IMediaEncodingProperties IMediaEncodingProperties

The encoding properties to set.

Returns

An IAsyncAction object that is used to control the asynchronous operation.

Remarks

This method sets the properties on the media source, which is the video capture device. This is unlike MediaCapture.SetEncodingPropertiesAsync, which changes the properties of the media encoding. For this reason, with SetMediaStreamPropertiesAsync you can only set properties and values that are supported natively by the capture device. Get a list of a capture device's supported resolutions, frame rates, and other properties by calling GetAvailableMediaStreamProperties. The benefit of setting the capture device properties instead of the media encoding is that the device only needs to generate enough data for the specified resolution, which can provide better performance than capturing at a high resolution and then downscaling at another point in the media capture pipeline. For more information, see Set format, resolution, and frame rate for MediaCapture and the Camera Resolution Sample.

See also