IMediaStream Interface

Microsoft DirectShow 9.0

IMediaStream Interface

• Note   This interface is deprecated. New applications should not use it.

The IMediaStream 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.

For sample code that implements the multimedia streaming interfaces, see Multimedia Streaming Sample Code.

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.

In addition to the methods inherited from IUnknown, the IMediaStream interface exposes the following methods.

Method	Description
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.
GetInformation	Retrieves the stream's purpose ID and media type.
GetMultiMediaStream	Retrieves a pointer to the multimedia stream that contains the specified media stream.
SendEndOfStream	Forces the current stream to end. If the current stream isn't writable, this method does nothing.
SetSameFormat	Sets the media stream to the same format as a previous stream.