MPEG1Source Sample

Shows how to write a custom media source in Microsoft Media Foundation. The sample implements a media source that parses MPEG-1 systems-layer streams and generates samples that contain MPEG-1 payloads.

APIs Demonstrated

This sample demonstrates the following Media Foundation interfaces:

• IMFByteStreamHandler
• IMFMediaSource
• IMFMediaStream

Before examining this sample, you might want to review the WavSource Sample, which provides a simpler implementation of a media source. The MPEG1Source sample adds some features that would be found in most real-world implementations of a media source:

• Multiple streams
• Asynchronous methods
• Asynchronous I/O

In the Windows SDK for Windows Server 2008, this sample also includes a sample MPEG-1 video decoder that displays the time code for each video frame. (It does not actually decode the MPEG-1 bitstream.)

Starting in the Windows SDK for Windows 7, the decoder has been moved to a separate sample. See Decoder Sample.

Usage

The MPEG1Source sample builds a DLL that is a COM server for the media source, media source's byte-stream handler, and the decoder MFT. Before using the media source, you must register the DLL.

To use the media source, you can run the BasicPlayback Sample. The source resolver will automatically load the media source if you select an MPEG-1 file for playback. (If an error occurs, make sure that you successfully registered the MPEG1Source DLL.)

You can also use the TopoEdit tool to build a playback topology that contains the media source. For more information about TopoEdit, see TopoEdit.

Requirements

Downloading the Sample

This sample is available in the Windows classic samples github repository.

Related topics

Media Foundation SDK Samples

Media Sources

Scheme Handlers and Byte-Stream Handlers

Tutorial: Writing a Custom Media Source

WavSource Sample