IMediaStream Interface

This interface provides access to the characteristics of a media stream, such as the stream's media type and purpose ID. It also has methods that create data samples.

Implement this interface when you want to add media type-specific functionality to your media stream. This interface is implemented on multimedia stream objects. IMediaStream provides generic sample-creation methods, but you usually want to write a more powerful version of these methods that will take advantage of your media type's specific characteristics.

Use this interface when your application needs to access a stream's media type information and create data samples.

Methods in Vtable Order

The following table shows the methods that appear in the Vtable beneath the standard COM methods inherited from IUnknown.

Method Description
GetMultiMediaStream Retrieves a pointer to the multimedia stream that contains the specified media stream.
GetInformation Retrieves the stream's purpose ID and media type.
SetSameFormat Sets the media stream to the same format as a previous stream.
AllocateSample Allocates a new stream sample object for the current media stream.
CreateSharedSample Creates a new stream sample that shares the same backing object as the existing sample.
SendEndOfStream Forces the current stream to end. If the current stream is not writable, this method does nothing.

Requirements

DirectShow applications and DirectShow filters have different include file and link library requirements. See Setting Up the Build Environment for more information.

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.

See Also

DirectShow Interfaces

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.