MediaEncodingProfile MediaEncodingProfile MediaEncodingProfile MediaEncodingProfile MediaEncodingProfile Class

Definition

Describes the encoding profile for an audio or video file. The encoding profile includes descriptions of the audio and video encoding formats, and a description of the media container.

public : sealed class MediaEncodingProfile : IMediaEncodingProfile, IMediaEncodingProfile2, IMediaEncodingProfile3
struct winrt::Windows::Media::MediaProperties::MediaEncodingProfile : IMediaEncodingProfile, IMediaEncodingProfile2, IMediaEncodingProfile3
public sealed class MediaEncodingProfile : IMediaEncodingProfile, IMediaEncodingProfile2, IMediaEncodingProfile3
Public NotInheritable Class MediaEncodingProfile Implements IMediaEncodingProfile, IMediaEncodingProfile2, IMediaEncodingProfile3
var mediaEncodingProfile = new mediaEncodingProfile();
Attributes

Windows 10 requirements

Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Remarks

The encoding quality Auto is a special preset that fills in the proper settings based on the current camera settings. Settings that are manually modified are ignored. For example, if you create a preset profile using one the static create methods, such as CreateM4a, and specify Auto as the encoding quality, any changes you make to the properties will be overwritten with values based on the current camera settings.

Note

It is possible to create a MediaEncodingProfile that is not supported on a particular device. For example, you may successfully call CreateMp3, but if an mp3 encoder is not present on the device, attempting to encode audio with the properties returned from this method will fail. For a list of the codecs present by default for each device family, see Supported codecs..

For how-to guidance for using MediaEncodingProfile to set the encoding properties for captured images, see Basic photo, video, and audio capture with MediaCapture. For information on using MediaEncodingProfile when transcoding media files, see Transcode media files.

Constructors

MediaEncodingProfile() MediaEncodingProfile() MediaEncodingProfile() MediaEncodingProfile() MediaEncodingProfile()

Creates a new instance of the MediaEncodingProfile class.

Properties

Audio Audio Audio Audio Audio

Gets or sets the encoding properties for the audio stream.

Container Container Container Container Container

Gets or sets the properties of the media container.

Video Video Video Video Video

Gets or sets the encoding properties for the video stream.

Methods

CreateAlac(AudioEncodingQuality) CreateAlac(AudioEncodingQuality) CreateAlac(AudioEncodingQuality) CreateAlac(AudioEncodingQuality) CreateAlac(AudioEncodingQuality)

Creates an instance of MediaEncodingProfile for Apple Lossless Audio Codec (ALAC) audio.

CreateAvi(VideoEncodingQuality) CreateAvi(VideoEncodingQuality) CreateAvi(VideoEncodingQuality) CreateAvi(VideoEncodingQuality) CreateAvi(VideoEncodingQuality)

Creates an instance of MediaEncodingProfile for AVI.

CreateFlac(AudioEncodingQuality) CreateFlac(AudioEncodingQuality) CreateFlac(AudioEncodingQuality) CreateFlac(AudioEncodingQuality) CreateFlac(AudioEncodingQuality)

Creates an instance of MediaEncodingProfile for Free Lossless Audio Codec (FLAC) audio.

CreateFromFileAsync(IStorageFile) CreateFromFileAsync(IStorageFile) CreateFromFileAsync(IStorageFile) CreateFromFileAsync(IStorageFile) CreateFromFileAsync(IStorageFile)

Creates an encoding profile from an existing media file.

CreateFromStreamAsync(IRandomAccessStream) CreateFromStreamAsync(IRandomAccessStream) CreateFromStreamAsync(IRandomAccessStream) CreateFromStreamAsync(IRandomAccessStream) CreateFromStreamAsync(IRandomAccessStream)

Creates an encoding profile from a stream that contains media data.

CreateHevc(VideoEncodingQuality) CreateHevc(VideoEncodingQuality) CreateHevc(VideoEncodingQuality) CreateHevc(VideoEncodingQuality) CreateHevc(VideoEncodingQuality)

Creates an instance of MediaEncodingProfile for High Efficiency Video Coding (HEVC) video, also known as H.265 video.

CreateM4a(AudioEncodingQuality) CreateM4a(AudioEncodingQuality) CreateM4a(AudioEncodingQuality) CreateM4a(AudioEncodingQuality) CreateM4a(AudioEncodingQuality)

Creates an encoding profile for AAC audio.

CreateMp3(AudioEncodingQuality) CreateMp3(AudioEncodingQuality) CreateMp3(AudioEncodingQuality) CreateMp3(AudioEncodingQuality) CreateMp3(AudioEncodingQuality)

Creates an encoding profile for MP3 (MPEG-1 layer 3) audio.

CreateMp4(VideoEncodingQuality) CreateMp4(VideoEncodingQuality) CreateMp4(VideoEncodingQuality) CreateMp4(VideoEncodingQuality) CreateMp4(VideoEncodingQuality)

Creates an encoding profile for H.264 video.

CreateWav(AudioEncodingQuality) CreateWav(AudioEncodingQuality) CreateWav(AudioEncodingQuality) CreateWav(AudioEncodingQuality) CreateWav(AudioEncodingQuality)

Creates an instance of MediaEncodingProfile for WAV

CreateWma(AudioEncodingQuality) CreateWma(AudioEncodingQuality) CreateWma(AudioEncodingQuality) CreateWma(AudioEncodingQuality) CreateWma(AudioEncodingQuality)

Creates an encoding profile for Windows Media Audio (WMA).

CreateWmv(VideoEncodingQuality) CreateWmv(VideoEncodingQuality) CreateWmv(VideoEncodingQuality) CreateWmv(VideoEncodingQuality) CreateWmv(VideoEncodingQuality)

Creates an encoding profile for Windows Media Video (WMV).

GetAudioTracks() GetAudioTracks() GetAudioTracks() GetAudioTracks() GetAudioTracks()

Retrieves the list of AudioStreamDescriptor objects describing the audio streams included in the MediaEncodingProfile.

GetTimedMetadataTracks() GetTimedMetadataTracks() GetTimedMetadataTracks() GetTimedMetadataTracks() GetTimedMetadataTracks()

Retrieves the list of TimedMetadataStreamDescriptor objects describing the timed metadata streams included in the MediaEncodingProfile.

GetVideoTracks() GetVideoTracks() GetVideoTracks() GetVideoTracks() GetVideoTracks()

Retrieves the list of VideoStreamDescriptor objects describing the video streams included in the MediaEncodingProfile.

SetAudioTracks(IIterable<AudioStreamDescriptor>) SetAudioTracks(IIterable<AudioStreamDescriptor>) SetAudioTracks(IIterable<AudioStreamDescriptor>) SetAudioTracks(IIterable<AudioStreamDescriptor>) SetAudioTracks(IIterable<AudioStreamDescriptor>)

Sets the list of AudioStreamDescriptor objects describing the audio streams included in the MediaEncodingProfile.

SetTimedMetadataTracks(IIterable<TimedMetadataStreamDescriptor>) SetTimedMetadataTracks(IIterable<TimedMetadataStreamDescriptor>) SetTimedMetadataTracks(IIterable<TimedMetadataStreamDescriptor>) SetTimedMetadataTracks(IIterable<TimedMetadataStreamDescriptor>) SetTimedMetadataTracks(IIterable<TimedMetadataStreamDescriptor>)

Sets the list of TimedMetadataStreamDescriptor objects describing the timed metadata streams included in the MediaEncodingProfile.

SetVideoTracks(IIterable<VideoStreamDescriptor>) SetVideoTracks(IIterable<VideoStreamDescriptor>) SetVideoTracks(IIterable<VideoStreamDescriptor>) SetVideoTracks(IIterable<VideoStreamDescriptor>) SetVideoTracks(IIterable<VideoStreamDescriptor>)

Sets the list of VideoStreamDescriptor objects describing the video streams included in the MediaEncodingProfile.

See also