CBaseRenderer.WaitForRenderTime 方法

  • 發行項

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

方法 WaitForRenderTime 會等候目前範例的呈現時間。

語法

virtual HRESULT WaitForRenderTime();

參數

這個方法沒有任何參數。

傳回值

傳回下列其中一個 HRESULT 值。

傳回碼 描述
S_OK
 成功。
VFW_E_STATE_CHANGED
 篩選狀態在簡報時間抵達之前變更。

備註

此方法會等到發生下列其中一項：

  • 樣本的呈現時間抵達，此時可以轉譯樣本。
  • 篩選會停止或開始排清資料。

如果簡報時間送達， 會發出 CBaseRenderer：：m_RenderEvent 事件的訊號。 如果狀態變更，就會發出 CBaseRenderer：：m_ThreadSignal 事件的訊號。 此方法會等候這兩個事件。 衍生類別可以視需要覆寫這個方法以等候其他事件。

此方法會在等候開始時呼叫 CBaseRenderer：：OnWaitStart 方法，並在等候完成時呼叫 CBaseRenderer：：OnWaitEnd 方法。 方法都不會在基類中執行任何動作，但衍生類別可以覆寫它們。

規格需求

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

另請參閱

CBaseRenderer 類別