ContainerEncodingProperties class

Applies to Windows and Windows Phone

Describes a media container format.

Syntax


public sealed class ContainerEncodingProperties : IMediaEncodingProperties

Attributes

[DualApiPartition()]
[MarshalingBehavior(Agile)]
[Threading(Both)]
[Version(0x06020000)]

Members

The ContainerEncodingProperties class has these types of members:

Constructors

The ContainerEncodingProperties class has these constructors.

ConstructorDescription
ContainerEncodingProperties Creates a new instance of the ContainerEncodingProperties class.

 

Methods

The ContainerEncodingProperties class inherits methods from the Object class (C#/VB/C++).

Properties

The ContainerEncodingProperties class has these properties.

PropertyAccess typeDescription

Properties

Read-onlyGets additional format properties for the media container.

Subtype

Read/writeGets or sets the subtype of the media container.

Type

Read-onlyGets the format type.

 

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.

Examples

The following example creates an instance of this class.


function getContainerFormat() {
    var containerProperties = new Windows.Media.MediaProperties.ContainerEncodingProperties();
    var containerType = containerProperties.type;
    var containerSubType = containerProperties.subtype;
    if (containerType === "Container" && containerSubType === "MPEG4") {
        // The format is an MPEG4 file container.
    }
}


Requirements

Minimum supported client

Windows 8 [Windows Store apps, desktop apps]

Minimum supported server

Windows Server 2012 [Windows Store apps, desktop apps]

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]

Namespace

Windows.Media.MediaProperties
Windows::Media::MediaProperties [C++]

Metadata

Windows.winmd

 

 

Show:
© 2014 Microsoft