COutputQueue.ReceiveMultiple 方法

[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayerIMFMediaEngineMedia Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayerIMFMediaEngine音频/视频捕获 ,而不是 DirectShow。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

方法 ReceiveMultiple 将一批媒体样本传送到输入引脚。

语法

HRESULT ReceiveMultiple(
   IMediaSample **ppSamples,
   long         nSamples,
   long         *nSamplesProcessed
);

参数

ppSamples

指向样本数组的指针的地址。

nSamples

数组中的样本数。

nSamplesProcessed

指向接收成功传递的示例数的变量的指针。

返回值

返回 HRESULT 值。 可能的值包括下表中显示的值。

返回代码 说明
S_FALSE
处理此示例之前收到的流结束通知。
S_OK
成功。

备注

如果对象使用线程,此方法会将数组中传递的所有样本排入队列。 否则,方法调用输入引脚上的 IMemInputPin::ReceiveMultiple 方法。

要求

要求
标头
Outputq.h (包括 Streams.h)

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

另请参阅

COutputQueue 类