CBaseInputPin 接收方法

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

語法

HRESULT Receive(
   IMediaSample *pSample
);

參數

pSample

範例 IMediaSample 介面的指標。

傳回值

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

傳回碼 Description
S _ 確定
成功。
S _ FALSE
Pin 目前正在排清;已拒絕範例。
E _ 指標
Null 指標引數。
VFW _ E _ INVALIDMEDIATYPE
媒體類型無效。
VFW _ E _ 運行時 _ 錯誤
發生執行階段錯誤。
VFW _ E _ 錯誤的 _ 狀態
已停止 pin。

備註

上游輸出圖釘會呼叫這個方法,以將範例傳遞給輸入的 pin。 輸入 pin 必須執行下列其中一項:

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

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

這個方法是同步的,而且可以封鎖。 如果此方法可能會封鎖,pin 的 CBaseInputPin:: ReceiveCanBlock 方法應該會傳回 s _ OK。

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

  1. 呼叫 CBaseInputPin:: CheckStreaming 方法,以確認釘選可以立即處理範例。 如果無法這樣做,例如,如果已停止 pin,方法將會失敗。
  2. 抓取範例屬性,並檢查格式是否已變更 (請參閱下面的) 。
  3. 如果格式已變更,則方法會呼叫 CBasePin:: CheckMediaType 方法,以判斷是否可接受新的格式。
  4. 如果無法接受新的格式,方法會呼叫 CBasePin:: EndOfStream 方法、張貼 EC _ ERRORABORT 事件,並傳回錯誤碼。
  5. 假設沒有任何錯誤,則方法會傳回 S _ OK。

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

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

規格需求

需求
標頭
Amfilter (包含: .h)
程式庫
(零售組建的 Strmbase .lib) ;
Strmbasd (debug 組建)

另請參閱

CBaseInputPin 類別