MediaCaptureInitializationSettings.PhotoMediaDescription MediaCaptureInitializationSettings.PhotoMediaDescription MediaCaptureInitializationSettings.PhotoMediaDescription MediaCaptureInitializationSettings.PhotoMediaDescription MediaCaptureInitializationSettings.PhotoMediaDescription Property

Definition

Gets or sets the media description for photo capture.

public : MediaCaptureVideoProfileMediaDescription PhotoMediaDescription { get; set; }
MediaCaptureVideoProfileMediaDescription PhotoMediaDescription();

void PhotoMediaDescription(MediaCaptureVideoProfileMediaDescription photomediadescription);
public MediaCaptureVideoProfileMediaDescription PhotoMediaDescription { get; set; }
Public ReadWrite Property PhotoMediaDescription As MediaCaptureVideoProfileMediaDescription
var mediaCaptureVideoProfileMediaDescription = mediaCaptureInitializationSettings.photoMediaDescription;
mediaCaptureInitializationSettings.photoMediaDescription = mediaCaptureVideoProfileMediaDescription;

Property Value

Additional features and requirements

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.

See also