CTransformFilter.Receive 方法

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

方法 Receive 接收媒体样本，对其进行处理，并将输出样本传送到下游筛选器。

语法

HRESULT Receive(
   IMediaSample *pSample
);

参数

pSample

指向输入示例上的 IMediaSample 接口的指针。

返回值

返回 HRESULT 值。 可能的值如下所示：

返回代码	说明
S_FALSE	上游筛选器应停止发送样本。
S_OK	成功。

备注

筛选器的输入引脚在收到样本时调用此方法。 此方法调用 CTransformFilter：：InitializeOutputSample 方法，该方法准备新的输出示例。 然后，它调用派生类必须实现的 CTransformFilter：：Transform 方法。 Transform 方法处理输入数据并生成输出数据。

如果 Transform 方法返回S_FALSE，该方法 Receive 将删除此示例。 在第一个已删除的样本中，筛选器将 EC_QUALITY_CHANGE 事件发送到筛选器关系图管理器。 否则，如果 Transform 方法返回S_OK，筛选器将传递输出示例。 为此，它会在下游输入引脚上调用 IMemInputPin：：Receive 方法。

要求

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

另请参阅

CTransformFilter 类