共用方式為


IMediaControl::P ause 方法 (control.h)

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

方法 Pause 會暫停篩選圖形中的所有篩選。

Syntax

HRESULT Pause();

傳回值

傳回 HRESULT 值。 可能的值如下。

傳回碼 Description
S_FALSE
圖表已順利暫停,但某些篩選尚未完成狀態轉換。
S_OK
圖形中的所有篩選都已完成轉換成暫停狀態的轉換。

備註

暫停篩選圖表會在下次執行圖形時提示圖形立即轉譯。 當圖表暫停時,篩選會處理數據,但不轉譯數據。 數據會透過圖形推送,並依轉換篩選條件處理,但轉譯器篩選條件不會轉譯數據。 不過,影片轉譯器會顯示第一個範例的靜態海報框架。

如果方法傳回S_FALSE,請呼叫 IMediaControl::GetState 方法來等候狀態轉換完成,或檢查轉換是否已完成。 當您呼叫 Pause 來顯示視訊檔案的第一個畫面時,請一律立即遵循它,並呼叫 GetState 以確保狀態轉換已完成。 若無法這麼做,可能會導致繪製黑色的視訊矩形。

如果方法失敗,它會在傳回之前停止圖形。

規格需求

需求
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 control.h (包含 Dshow.h)
程式庫 Strmiids.lib

另請參閱

錯誤和成功碼

IMediaControl 介面

IMediaControl::StopWhenReady