Share via

IMediaFilter：:P ause 方法 (strmif.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
 成功。 轉換已完成。

備註

當篩選暫停時，它可以接收、處理和傳遞範例。 不過，轉譯器篩選只會在暫停時接受一個樣本。 因此，當篩選圖表暫停時，樣本會移動圖表，直到第一個樣本到達轉譯器為止。 此時，串流會暫停，直到呼叫 IMediaFilter：：Run 方法為止。 視訊轉譯器會將第一個範例顯示為仍然畫面。

即時擷取篩選不會在暫停時提供任何範例，只會在執行時提供。

狀態轉換可能是非同步。 如果方法在轉換完成之前傳回，則傳回值 會S_FALSE。 在 (1) 收到一個範例之前，轉譯器篩選不會完成要暫停的轉換，或 (2) 收到資料流程結束通知。 狀態轉換擱置時， IMediaFilter：：GetState 會傳回 VFW_S_STATE_INTERMEDIATE。

規格需求

   
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 strmif.h (包含 Dshow.h)
程式庫 Strmiids.lib

另請參閱

錯誤和成功碼

IBaseFilter

IMediaFilter 介面