共用方式為

IMediaEvent：：WaitForCompletion 方法 (control.h)

  • 發行項

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

方法 WaitForCompletion 會等候篩選圖形轉譯所有可用的資料。 篩選圖表必須正在執行，否則方法會失敗。

語法

HRESULT WaitForCompletion(
  [in]  long msTimeout,
  [out] long *pEvCode
);

參數

[in] msTimeout

逾時間隔，以毫秒為單位。 傳遞零以立即傳回。 傳遞 INFINITE 值以無限期封鎖。

[out] pEvCode

接收事件程式碼之變數的指標。 如需詳細資訊，請參閱「備註」。

傳回值

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

傳回碼 描述
S_OK
 成功。
E_ABORT
 逾時已過期。
VFW_E_WRONG_STATE
 篩選圖表未執行。

備註

這個方法會封鎖直到逾時到期，或發生下列其中一個事件：

在等候期間，方法會捨棄所有其他事件通知。

如果傳回值S_OK， pEvCode 參數會收到結束等候的事件碼。 當方法傳回時，篩選圖表仍在執行中。 應用程式可以視需要暫停或停止圖形。

規格需求

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

另請參閱

錯誤和成功碼

IMediaEvent 介面