MediaCaptureInitializationSettings.PhotoMediaDescription Property

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

Gets or sets the media description for photo capture.

public:
 property MediaCaptureVideoProfileMediaDescription ^ PhotoMediaDescription { MediaCaptureVideoProfileMediaDescription ^ get(); void set(MediaCaptureVideoProfileMediaDescription ^ value); };

MediaCaptureVideoProfileMediaDescription PhotoMediaDescription();

void PhotoMediaDescription(MediaCaptureVideoProfileMediaDescription value);

public MediaCaptureVideoProfileMediaDescription PhotoMediaDescription { get; set; }

var mediaCaptureVideoProfileMediaDescription = mediaCaptureInitializationSettings.photoMediaDescription;
mediaCaptureInitializationSettings.photoMediaDescription = mediaCaptureVideoProfileMediaDescription;

Public Property PhotoMediaDescription As MediaCaptureVideoProfileMediaDescription

Property Value

MediaCaptureVideoProfileMediaDescription

The media description for photo capture.

Windows requirements

App capabilities

backgroundMediaRecording

Remarks

An instance of MediaCaptureVideoProfileMediaDescription defines a group of capture settings that are supported by a video profile. For example, one MediaCaptureVideoProfileMediaDescription object could represent settings for recording 720p video at 30 fps with HDR video and another could represent settings for recording 1080p video at 30 fps without HDR video support. A MediaCaptureVideoProfile object contains separate lists of supported media descriptions for photo capture, preview, and video recording that are supported for that profile. For more information on video profiles, see MediaCaptureVideoProfile.

The way the system uses the PhotoMediaDescription property depends on the value of the VideoProfile property.

If you set VideoProfile to a non-null value and you set PhotoMediaDescription to a value in the video profile's SupportedPhotoMediaDescription list, the system will use your provided media description and will provide optimization hints to the driver based on the profile you specify.
If you set VideoProfile to a non-null value and the value of PhotoMediaDescription is not set, then the system will use the first entry in the video profile's SupportedPhotoMediaDescription list as the media description.
If the value of VideoProfile is not set at all then the system ignores the value of PhotoMediaDescription and reverts to the legacy behavior before the video profile APIs were introduced.

Applies to