CBaseInputPin.Receive 方法

  • 發行項

[與此頁面相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。

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

語法

HRESULT Receive(
   IMediaSample *pSample
);

參數

pSample

範例 IMediaSample 介面的指標。

傳回值

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

傳回碼 描述
S_OK
 成功。
S_FALSE
 針腳目前正在排清;範例遭到拒絕。
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 類別