CBaseRenderer.Receive 方法
[與此頁面相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。
方法 Receive 會接收資料流程中的下一個媒體範例。
語法
virtual Receive(
IMediaSample *pMediaSample
);
參數
-
pMediaSample
-
範例 IMediaSample 介面的指標。
傳回值
如果成功，則傳回S_OK，或指出錯誤原因的 HRESULT 值。
備註
輸入針腳從上游篩選收到範例時，會呼叫這個方法。
如果篩選正在執行，這個方法會執行下列步驟：
- 排程轉譯 (CBaseRenderer：:P repareReceive) 的範例。
- 等候 CBaseRenderer：：WaitForRenderTime) 的排程 (時間。
- 轉譯 範例 (CBaseRenderer：：Render) 。
- 釋放 (CBaseRenderer：：ClearPendingSample) 範例。
如果篩選已暫停，方法會執行下列步驟：
- 通知衍生類別範例 (CBaseRenderer：：OnReceiveFirstSample) 。
- 等候排程的時間。
- 轉譯範例。
- 釋放範例。
暫停時，方法會在步驟 2 中等候，直到篩選切換至執行中狀態為止。 此時，篩選會排程範例。
在基類中， OnReceiveFirstSample 方法不會執行任何動作。 衍生類別可以覆寫它。 例如，當影片轉譯器暫停時，它會將第一個範例顯示為仍在影像。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 |
|
| 程式庫 |
|