IMediaSample2 Interface

Microsoft DirectShow 9.0

IMediaSample2 Interface

The IMediaSample2 interface sets and retrieves properties on media samples.

This interface inherits the IMediaSample interface. Whereas the IMediaSample interface requires separate method calls for each sample property, the IMediaSample2 interface has methods for setting and retrieving multiple properties at once.

Media samples are not guaranteed to support IMediaSample2. However, if an allocator creates samples that support IMediaSample2, all of the samples that it creates must support the interface. For any given media sample, the IMediaSample2::GetProperties method returns the same values as the individual IMediaSample methods. Therefore, you can use whichever version you prefer.

In addition to the methods inherited from IMediaSample, the IMediaSample2 interface exposes the following methods.

Method	Description
GetProperties	Retrieves the properties of a media sample.
SetProperties	Sets the properties of a media sample.

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.