CMediaSample 类

cmediasample class hierarchy

CMediaSample 类定义支持 IMediaSample2 接口的媒体示例。 媒体示例包含指向内存缓冲区的指针,以及存储为受保护成员变量的各种属性。

媒体示例由分配器创建,这些分配器派生自 CBaseAllocator 类。 构造 CMediaSample 函数接收指向已分配缓冲区的指针以及缓冲区的大小。 其他属性通常通过 IMediaSample 接口方法进行设置和检索。

媒体示例的生命周期不同于大多数 COM 对象的生命周期:

  • 分配器包含免费示例列表。 当筛选器需要新示例时,它会调用分配器的 IMemAllocator::GetBuffer 方法。 分配器从其可用列表中检索样本,递增样本的引用计数,并返回指向样本的指针。
  • 使用示例完成筛选器后,它会在示例中调用 IUnknown::Release 方法。 与大多数对象不同,当样本的引用计数达到零时,该示例不会删除自身。 相反,它会在分配器上调用 IMemAllocator::ReleaseBuffer 方法,分配器将示例返回到其免费列表。
  • 在调用 IMemAllocator::D ecommit 方法之前,分配器不会销毁样本。
受保护的成员变量 说明
m_dwFlags 示例属性标志。
m_dwTypeSpecificFlags 特定于类型的标志。
m_pBuffer 指向包含媒体数据的内存缓冲区的指针。
m_lActual 缓冲区中有效数据的长度(以字节为单位)。
m_cbBuffer 缓冲区的大小(以字节为单位)。
m_pAllocator 指向创建此示例的分配器的指针。
m_pNext 指向分配器示例列表中的下一个示例的指针。
m_Start 示例开始时间。
m_End 示例结束时间。
m_MediaStart 媒体开始时间。
m_MediaEnd 媒体停止时间。
m_pMediaType 如果类型已从数据流中的上一个示例更改,则指向媒体类型的指针。
m_dwStreamId 流标识符。
公共成员变量 说明
m_cRef 引用计数。
公共方法 描述
CMediaSample 构造函数方法。
~ CMediaSample 析构函数方法。 虚拟。
SetPointer 设置指向内存缓冲区的指针。
IMediaSample 方法 描述
GetPointer 检索指向缓冲区的读/写指针。
GetSize 检索缓冲区的大小。
GetTime 检索此示例应开始和完成的流时间。
SetTime 设置此示例应启动和完成的流时间。
IsSyncPoint 确定示例的开头是否为同步点。
SetSyncPoint 指定此示例的开头是否为同步点。
IsPreroll 确定此示例是否为预注册示例。
SetPreroll 指定此示例是否为预注册示例。
GetActualDataLength 检索缓冲区中有效数据的长度。
SetActualDataLength 设置缓冲区中有效数据的长度。
GetMediaType 如果媒体类型与上一个示例不同,则检索媒体类型。
SetMediaType 设置示例的媒体类型。
IsDiscontinuity 确定此示例是否表示数据流中的中断。
SetDiscontinuity 指定此示例是否表示数据流中的中断。
GetMediaTime 检索此示例的媒体时间。
SetMediaTime 设置此示例的媒体时间。
IMediaSample2 方法 说明
GetProperties 检索示例的属性。
SetProperties 设置示例的属性。

要求

要求 Value
标头
Amfilter.h (包括 Streams.h)

Strmbase.lib (零售版) ;
Strmbasd.lib (调试生成)