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

  • 發行項

[與此頁面 相關的功能 DirectShow 是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對 Windows 10 和 Windows 11 進行優化。 Microsoft 強烈建議新程式代碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 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