MediaCaptureSettings Class

Reference

Definition

Namespace:: Windows.Media.Capture

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

Contains read-only configuration settings for the MediaCapture object.

public ref class MediaCaptureSettings 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 MediaCaptureSettings 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 MediaCaptureSettings

Public NotInheritable Class MediaCaptureSettings

Inheritance: Object Platform::Object IInspectable MediaCaptureSettings

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)
App capabilities	backgroundMediaRecording microphone webcam

Remarks

To get an instance of this class, retrieve the MediaCapture.MediaCaptureSettings property.

For how-to guidance for using the MediaCapture object to capture audio, photos, and video, see Camera.

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).

Version history

Windows version	SDK version	Value added
1803	17134	Direct3D11Device

Properties

AudioDeviceId	Gets the DeviceInformation.Id of the microphone.
AudioProcessing	Gets the audio processing mode.
CameraSoundRequiredForRegion	Gets a value that indicates if the device’s region requires that a sound be played when a photo or video is captured.
ConcurrentRecordAndPhotoSequenceSupported	Gets a value that indicates if the capture device supports recording video and taking a photo sequence at the same time.
ConcurrentRecordAndPhotoSupported	Gets a value that indicates if the capture device supports recording video and taking a photo at the same time.
Direct3D11Device	Gets an IDirect3DDevice representing the Direct3D device instance being used by the associated MediaCapture object.
Horizontal35mmEquivalentFocalLength	Gets the horizontal 35mm equivalent focal length of the camera lens on the capture device.
MediaCategory	Gets the media category of the media.
PhotoCaptureSource	Gets the stream that is used for photo capture.
PitchOffsetDegrees	Gets the pitch offset of the camera in degrees.
StreamingCaptureMode	Gets the streaming mode.
Vertical35mmEquivalentFocalLength	Gets the vertical 35mm equivalent focal length of the camera lens on the capture device.
VideoDeviceCharacteristic	Gets a value that indicates which video streams are independent of each other.
VideoDeviceId	Gets the DeviceInformation.Id of the video camera.

Applies to

Jaa