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
。
規格需求
需求 | 值 |
---|---|
標頭 |
|
程式庫 |
|