| Microsoft DirectX 8.1 (C++) |
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. |