CBaseAllocator.ReleaseBuffer 方法

[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayer、 IMFMediaEngine 和 媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

方法 ReleaseBuffer 将媒体样本返回到免费媒体样本列表。 此方法实现 IMemAllocator：：ReleaseBuffer 方法。

语法

HRESULT ReleaseBuffer(
   IMediaSample *pSample
);

参数

pSample

指向媒体示例对象的 IMediaSample 接口的指针。

返回值

返回 S_OK。

注解

当媒体样本的引用计数达到零时，该示例会调用 ReleaseBuffer ，并将自身作为 参数。 此方法执行以下操作。

• 将媒体示例返回到自由列表 (CBaseAllocator：：m_lFree) 。
• 调用 CBaseAllocator：：NotifySample 方法，该方法释放在调用 CBaseAllocator：：GetBuffer 方法时被阻止的任何线程。
• 如果以前调用了 CBaseAllocator：：SetNotify 方法，则调用 IMemAllocatorNotifyCallbackTemp：：NotifyRelease 方法。
• 释放最后一个示例时，如果有挂起的 CBaseAllocator：:D ecommit 调用，则调用 CBaseAllocator：：Free 方法来释放缓冲区内存。 (在基类中， Free 是纯虚拟方法。)

要求

要求	值
标头	Amfilter.h (包括 Streams.h)
库	Strmbase.lib (零售版本) ; Strmbasd.lib (调试生成)

另请参阅

CBaseAllocator 类