IAMMediaTypeSample interface (amstream.h)

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

This interface contains methods for manipulating stream samples with arbitrary media types. Call the IAMMediaTypeStream::CreateSample method to create a sample that exposes this interface.

The methods in this interface parallel those of the IMediaSample interface, although IAMMediaTypeSample contains a SetPointer method in addition to the GetPointer method.

Inheritance

The IAMMediaTypeSample interface inherits from IStreamSample. IAMMediaTypeSample also has these types of members:

• Methods

Methods

The IAMMediaTypeSample interface has these methods.

IAMMediaTypeSample::GetActualDataLength Note  This interface is deprecated. New applications should not use it. The GetActualDataLength method retrieves the data length of the sample, in bytes.
IAMMediaTypeSample::GetMediaTime Note  This interface is deprecated. New applications should not use it. The GetMediaTime method retrieves the media time stamps for the sample.
IAMMediaTypeSample::GetMediaType Note  This interface is deprecated. New applications should not use it. The GetMediaType method retrieves the media type of the sample. If the format has not changed from the previous sample, the sample might not carry a media type.
IAMMediaTypeSample::GetPointer Note  This interface is deprecated. New applications should not use it. The GetPointer method retrieves a read/write pointer to the buffer's memory.
IAMMediaTypeSample::GetSize Note  This interface is deprecated. New applications should not use it. The GetSize method retrieves the size of the buffer data area, in bytes.
IAMMediaTypeSample::GetTime Note  This interface is deprecated. New applications should not use it. The GetTime method retrieves the stream times at which the sample should start and stop.
IAMMediaTypeSample::IsDiscontinuity Note  This interface is deprecated. New applications should not use it. The IsDiscontinuity method determines if this sample represents a discontinuity in the data stream.
IAMMediaTypeSample::IsPreroll Note  This interface is deprecated. New applications should not use it. The IsPreroll method determines if this sample is part of the preroll. A preroll sample should not be displayed.
IAMMediaTypeSample::IsSyncPoint Note  This interface is deprecated. New applications should not use it. The IsSyncPoint method determines if the beginning of a sample is a synchronization point.
IAMMediaTypeSample::SetActualDataLength Note  This interface is deprecated. New applications should not use it. The SetActualDataLength method sets the sample's data length.
IAMMediaTypeSample::SetDiscontinuity Note  This interface is deprecated. New applications should not use it. The SetDiscontinuity method sets the discontinuity property.
IAMMediaTypeSample::SetMediaTime Note  This interface is deprecated. New applications should not use it. The SetMediaTime method sets the media time stamps for this sample.
IAMMediaTypeSample::SetMediaType Note  This interface is deprecated. New applications should not use it. The SetMediaType method sets the media type for the sample.
IAMMediaTypeSample::SetPointer Note  This interface is deprecated. New applications should not use it. The SetPointer method sets the pointer to the media sample's memory buffer.
IAMMediaTypeSample::SetPreroll Note  This interface is deprecated. New applications should not use it. The SetPreroll method specifies whether this is a preroll sample. A preroll sample should not be displayed.
IAMMediaTypeSample::SetSyncPoint Note  This interface is deprecated. New applications should not use it. The SetSyncPoint method specifies whether the beginning of this sample is a synchronization point.
IAMMediaTypeSample::SetTime Note  This interface is deprecated. New applications should not use it. The SetTime method sets the stream times at which the sample should start and stop.

Requirements

Requirement	Value
Target Platform	Windows
Header	amstream.h

See also

IStreamSample