CBaseInputPin.ReceiveMultiple 方法

方法 ReceiveMultiple 會接收樣本陣列。 這個方法會實作 IMemInputPin::ReceiveMultiple 方法。

語法

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

參數

pSamples

IMediaSample指標陣列的位址,大小為 nSamples

nSamples

要處理的範例數目。

nSamplesProcessed

接收已處理之樣本數目的變數指標。

傳回值

傳回 HRESULT 值。 可能的值包括下表所列的值。

傳回碼 描述
S_OK
成功。
S_FALSE
Pin 目前正在排清;範例遭到拒絕。
E_POINTER
Null 指標引數。
VFW_E_INVALIDMEDIATYPE
不正確媒體類型。
VFW_E_RUNTIME_ERROR
發生執行階段錯誤。
VFW_E_WRONG_STATE
針腳已停止。

備註

此方法的行為類似 CBaseInputPin::Receive 方法,但會收到樣本陣列。 在基類中,方法會迴圈執行陣列,並使用每個範例呼叫 Receive 。 如果您的篩選準則可以比一次處理一個批次更有效率地處理樣本批次,請覆寫此函式。

規格需求

需求
標頭
Amfilter.h (包含 Streams.h)
程式庫
Strmbase.lib (零售組建) ;
Strmbasd.lib (偵錯組建)

另請參閱

CBaseInputPin 類別