ContainerEncodingProperties ContainerEncodingProperties ContainerEncodingProperties ContainerEncodingProperties Class

Definition

Describes a media container format.

public sealed class ContainerEncodingPropertiespublic sealed class ContainerEncodingPropertiesPublic NotInheritable Class ContainerEncodingPropertiespublic sealed class ContainerEncodingProperties
Attributes
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Remarks

Media files usually contain at least some of the following elements:

  • File headers that describe the number of streams, the format of each stream, and so on.
  • An index that enables random access to the content.
  • Metadata that describes the content (for example, the artist or title).

The term media container describes the entire package of media data, file headers, indexes, and metadata. The reason for using the term container rather than file is that some container formats are designed for live broadcast. A container might be generated in real time, without ever being stored as a file.

An early example of a media container is the AVI file format. Other examples include MP4 and Advanced Systems Format (ASF). Containers can be identified by file name extension (for example, ".mp4") or by MIME type.

Constructors

ContainerEncodingProperties() ContainerEncodingProperties() ContainerEncodingProperties() ContainerEncodingProperties()

Creates a new instance of the ContainerEncodingProperties class.

public ContainerEncodingProperties()public New()Public Sub New()public ContainerEncodingProperties()
Attributes
Additional features and requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Properties

Properties Properties Properties Properties

Gets additional format properties for the media container.

public MediaPropertySet Properties { get; }public MediaPropertySet Properties { get; }Public ReadOnly Property Properties As MediaPropertySetpublic MediaPropertySet Properties { get; }
Value
MediaPropertySet MediaPropertySet MediaPropertySet MediaPropertySet

A property set that contains format properties.

Attributes
Additional features and requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Remarks

For information on working with a property set collection, see PropertySet.

Subtype Subtype Subtype Subtype

Gets or sets the subtype of the media container.

public string Subtype { get; set; }public string Subtype { get; set; }Public ReadWrite Property Subtype As stringpublic string Subtype { get; set; }
Value
string string string string

The subtype.

Attributes
Additional features and requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Remarks

The value can be the string representation of a GUID in canonical form, or one of the predefined values listed in the following table.

ValueDescription
"3GP"3GP file.
"AC3"AC-3 audio.
"ADTS"Audio Data Transport Stream (ADTS) stream.
"MP3"MPEG Audio Layer-3 (MP3).
"MPEG2PS"MPEG-2 program stream.
"MPEG2TS"MPEG-2 transport stream.
"MPEG4"MP4 file container.

Warning

The string values returned by the MediaEncodingSubtypes properties may not use the same letter casing as Subtype, Subtype, Subtype, and Subtype. For this reason, if you compare the values, you should use a case-insensitive comparison or use hardcoded strings that match the casing returned by the encoding properties.

Type Type Type Type

Gets the format type.

public string Type { get; }public string Type { get; }Public ReadOnly Property Type As stringpublic string Type { get; }
Value
string string string string

The format type. For media containers, the format type is "Container".

Attributes
Additional features and requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)