ContainerEncodingProperties ContainerEncodingProperties ContainerEncodingProperties ContainerEncodingProperties Class

Describes a media container format.

Syntax

Declaration

public sealed class ContainerEncodingPropertiespublic sealed class ContainerEncodingPropertiesPublic NotInheritable Class ContainerEncodingPropertiespublic sealed class ContainerEncodingProperties

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 summary

Creates a new instance of the ContainerEncodingProperties class.

Properties summary

Gets additional format properties for the media container.

Gets or sets the subtype of the media container.

Gets the format type.

Constructors

  • ContainerEncodingProperties()
    ContainerEncodingProperties()
    ContainerEncodingProperties()
    ContainerEncodingProperties()

    Creates a new instance of the ContainerEncodingProperties class.

    public ContainerEncodingProperties()public New()Public Sub New()public ContainerEncodingProperties()

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; }

    Property Value

    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; }

    Property Value

    • string
      string
      string
      string

      The subtype.

    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; }

    Property Value

    • string
      string
      string
      string

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

Device family

Windows 10 (introduced v10.0.10240.0)

API contract

Windows.Foundation.UniversalApiContract (introduced v1)

Attributes

Windows.Foundation.Metadata.ActivatableAttribute
Windows.Foundation.Metadata.ContractVersionAttribute
Windows.Foundation.Metadata.DualApiPartitionAttribute
Windows.Foundation.Metadata.MarshalingBehaviorAttribute
Windows.Foundation.Metadata.ThreadingAttribute

Details

Assembly

Windows.Media.MediaProperties.dll