CBaseRenderer.SourceThreadCanWait 方法

  • 發行項

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

方法 SourceThreadCanWait 會保存或釋放串流執行緒。

語法

virtual HRESULT SourceThreadCanWait(
   BOOL bCanWait
);

參數

bCanWait

布林值，指出是否要保存串流執行緒。 如果 為 TRUE，則串流執行緒會在篩選等候轉譯下一個樣本時遭到封鎖。 如果 為 FALSE，則會釋放串流執行緒。

傳回值

傳回S_OK。

備註

SourceThreadCanWait使用FALSE值呼叫 方法，會強制篩選從封鎖的IMemInputPin：：Receive呼叫傳回。 篩選執行時，它會封鎖 接收 呼叫，直到目前範例的簡報時間為止。 當篩選暫停時，它會無限期封鎖 接收 呼叫。 此行為會規範資料流程中的資料流程程。 不過，當篩選停止或排清時，它不應該封鎖。

封鎖是由 CBaseRenderer：：WaitForRenderTime 方法所控制，此方法會等候兩個事件： CBaseRenderer：：m_RenderEvent 和 CBaseRenderer：：m_ThreadSignal。 當簡報時間送達時，會發出 m_RenderEvent 事件訊號。 使用FALSE值呼叫 時 SourceThreadCanWait ，會發出m_ThreadSignal事件訊號。 使用TRUE值呼叫 SourceThreadCanWait 會重設 事件。

CBaseRenderer：：Stop和CBaseRenderer：：BeginFlush方法會以FALSE值呼叫 SourceThreadCanWait ， (釋放串流執行緒) 。 CBaseRenderer：:P ause、CBaseRenderer：：Run和CBaseRenderer：：EndFlush方法會以TRUE值呼叫 SourceThreadCanWait 。

規格需求

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

另請參閱

CBaseRenderer 類別