MediaCapture.PrepareAdvancedPhotoCaptureAsync(ImageEncodingProperties) MediaCapture.PrepareAdvancedPhotoCaptureAsync(ImageEncodingProperties) MediaCapture.PrepareAdvancedPhotoCaptureAsync(ImageEncodingProperties) MediaCapture.PrepareAdvancedPhotoCaptureAsync(ImageEncodingProperties) MediaCapture.PrepareAdvancedPhotoCaptureAsync(ImageEncodingProperties) Method

Definition

Initializes the advanced photo capture and provides the AdvancedPhotoCapture object used to manage the recording.

public : IAsyncOperation<AdvancedPhotoCapture> PrepareAdvancedPhotoCaptureAsync(ImageEncodingProperties encodingProperties)
IAsyncOperation<AdvancedPhotoCapture> PrepareAdvancedPhotoCaptureAsync(ImageEncodingProperties encodingProperties) const;
public IAsyncOperation<AdvancedPhotoCapture> PrepareAdvancedPhotoCaptureAsync(ImageEncodingProperties encodingProperties)
Public Function PrepareAdvancedPhotoCaptureAsync(encodingProperties As ImageEncodingProperties) As IAsyncOperation(Of AdvancedPhotoCapture)
Windows.Media.Capture.MediaCapture.prepareAdvancedPhotoCaptureAsync(encodingProperties).done( /* Your success and error handlers */ );

Parameters

encodingProperties
ImageEncodingProperties ImageEncodingProperties ImageEncodingProperties

The encoding properties used for the resulting image.

Returns

Additional features and requirements

Capabilities
backgroundMediaRecording

Remarks

Note

Starting with Windows 10, version 1709, recording video and using AdvancedPhotoCapture concurrently is supported. This is not supported in previous versions. This change means that you can have a prepared LowLagMediaRecording and AdvancedPhotoCapture at the same time. You can start or stop video recording between calls to MediaCapture.PrepareAdvancedPhotoCaptureAsync and AdvancedPhotoCapture.FinishAsync. You can also call AdvancedPhotoCapture.CaptureAsync while video is recording. However, some AdvancedPhotoCapture scenarios, like capturing an HDR photo while recording video would cause some video frames to be altered by the HDR capture, resulting in a negative user experience. For this reason, the list of modes returned by the AdvancedPhotoControl.SupportedModes will be different while video is recording. You should check this value immediately after starting or stopping video recording to ensure that the desired mode is supported in the current video recording state.