共用方式為

CBaseRenderer.PrepareReceive 方法

  • 發行項

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

方法 PrepareReceive 會準備篩選準則以轉譯樣本。

語法

virtual HRESULT PrepareReceive(
   IMediaSample *pMediaSample
);

參數

pMediaSample

範例 IMediaSample 介面的指標。

傳回值

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

傳回碼 描述
S_OK
 成功。
E_FAIL
 失敗。
E_UNEXPECTED
 非預期的錯誤。
VFW_E_SAMPLE_REJECTED
 篩選正在卸載此範例。

備註

篩選會先從 CBaseRenderer：：Receive 方法內呼叫這個方法，再轉譯範例。 如果篩選正在執行，這個方法會排程範例以進行轉譯。

如果篩選已經有擱置的樣本，或已到達資料流程結尾，方法會傳回E_UNEXPECTED。 上游篩選可能未正確序列化其串流呼叫。

如果排程演算法判斷應該卸載範例 (請參閱 CBaseRenderer：：ScheduleSample) ，此方法會傳回VFW_E_SAMPLE_REJECTED。 不過，輸入針腳的 IMemInputPin：：Receive 方法不會將此錯誤碼傳遞至上游篩選，因為卸載範例不是錯誤。

規格需求

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

另請參閱

CBaseRenderer 類別