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 是纯虚拟方法。)
要求
| 要求 | 值 |
|---|---|
| 标头 |
|
| 库 |
|