CBaseInputPin.Receive 方法

方法 Receive 會接收資料流程中的下一個媒體範例。 這個方法會實作 IMemInputPin::Receive 方法。

語法

HRESULT Receive(
   IMediaSample *pSample
);

參數

pSample

範例 IMediaSample 介面的指標。

傳回值

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

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

備註

上游輸出針腳會呼叫這個方法,以將範例傳遞至輸入針腳。 輸入針腳必須執行下列其中一項:

  • 在傳回之前處理範例。
  • 傳回並處理背景工作執行緒中的範例。
  • 拒絕範例。

如果針腳使用背景工作執行緒來處理範例,請將參考計數新增至這個方法內的範例。 方法傳回之後,上游針腳會釋放範例。 當樣本的參考計數達到零時,範例會傳回配置器以供重複使用。

這個方法是同步的,而且可以封鎖。 如果方法可能會封鎖,則針腳的 CBaseInputPin::ReceiveCanBlock 方法應該會傳回S_OK。

在基類中,此方法會執行下列步驟:

  1. 呼叫 CBaseInputPin::CheckStreaming 方法,以確認釘選現在可以處理範例。 例如,如果針腳停止,方法就會失敗。
  2. 擷取範例屬性,並檢查格式是否已變更, (請參閱下方) 。
  3. 如果格式已變更,方法會呼叫 CBasePin::CheckMediaType 方法,以判斷是否可接受的新格式。
  4. 如果無法接受新的格式,方法會呼叫 CBasePin::EndOfStream 方法、張貼EC_ERRORABORT事件,並傳回錯誤碼。
  5. 假設沒有任何錯誤,此方法會傳回S_OK。

測試格式變更,如下所示:

在基類中,這個方法不會處理範例。 衍生類別必須覆寫這個方法來執行處理。 (這需要的內容完全取決於 filter.) 衍生類別應該呼叫基類方法,以檢查先前所述的錯誤。

規格需求

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

另請參閱

CBaseInputPin 類別