MediaCaptureSettings MediaCaptureSettings MediaCaptureSettings MediaCaptureSettings MediaCaptureSettings Class


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

Prerelease APIs are identified by a Prerelease label.

[Contains prerelease APIs.]
Contains read-only configuration settings for the MediaCapture object.

public : sealed class MediaCaptureSettings : IMediaCaptureSettings, IMediaCaptureSettings2
struct winrt::Windows::Media::Capture::MediaCaptureSettings : IMediaCaptureSettings, IMediaCaptureSettings2
public sealed class MediaCaptureSettings : IMediaCaptureSettings, IMediaCaptureSettings2
Public NotInheritable Class MediaCaptureSettings Implements IMediaCaptureSettings, IMediaCaptureSettings2
// This class does not provide a public constructor.
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)
webcam backgroundMediaRecording microphone


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.


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


AudioDeviceId AudioDeviceId AudioDeviceId AudioDeviceId AudioDeviceId

Gets the DeviceInformation.Id of the microphone.

AudioProcessing AudioProcessing AudioProcessing AudioProcessing AudioProcessing

Gets the audio processing mode.

CameraSoundRequiredForRegion CameraSoundRequiredForRegion CameraSoundRequiredForRegion CameraSoundRequiredForRegion 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 ConcurrentRecordAndPhotoSequenceSupported ConcurrentRecordAndPhotoSequenceSupported ConcurrentRecordAndPhotoSequenceSupported ConcurrentRecordAndPhotoSequenceSupported

Gets a value that indicates if the capture device supports recording video and taking a photo sequence at the same time.

ConcurrentRecordAndPhotoSupported ConcurrentRecordAndPhotoSupported ConcurrentRecordAndPhotoSupported ConcurrentRecordAndPhotoSupported ConcurrentRecordAndPhotoSupported

Gets a value that indicates if the capture device supports recording video and taking a photo at the same time.

Direct3D11Device Direct3D11Device Direct3D11Device Direct3D11Device Direct3D11Device

Prerelease. Gets an IDirect3DDevice representing the Direct3D device instance being used by the associated MediaCapture object.

Horizontal35mmEquivalentFocalLength Horizontal35mmEquivalentFocalLength Horizontal35mmEquivalentFocalLength Horizontal35mmEquivalentFocalLength Horizontal35mmEquivalentFocalLength

Gets the horizontal 35mm equivalent focal length of the camera lens on the capture device.

MediaCategory MediaCategory MediaCategory MediaCategory MediaCategory

Gets the media category of the media.

PhotoCaptureSource PhotoCaptureSource PhotoCaptureSource PhotoCaptureSource PhotoCaptureSource

Gets the stream that is used for photo capture.

PitchOffsetDegrees PitchOffsetDegrees PitchOffsetDegrees PitchOffsetDegrees PitchOffsetDegrees

Gets the pitch offset of the camera in degrees.

StreamingCaptureMode StreamingCaptureMode StreamingCaptureMode StreamingCaptureMode StreamingCaptureMode

Gets the streaming mode.

Vertical35mmEquivalentFocalLength Vertical35mmEquivalentFocalLength Vertical35mmEquivalentFocalLength Vertical35mmEquivalentFocalLength Vertical35mmEquivalentFocalLength

Gets the vertical 35mm equivalent focal length of the camera lens on the capture device.

VideoDeviceCharacteristic VideoDeviceCharacteristic VideoDeviceCharacteristic VideoDeviceCharacteristic VideoDeviceCharacteristic

Gets a value that indicates which video streams are independent of each other.

VideoDeviceId VideoDeviceId VideoDeviceId VideoDeviceId VideoDeviceId

Gets the DeviceInformation.Id of the video camera.