IMediaEvent 介面 (control.h)
[與此頁面 相關的功能 DirectShow 是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對 Windows 10 和 Windows 11 進行優化。 Microsoft 強烈建議新程式代碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式代碼，以使用新的 API。]
介面 IMediaEvent 包含擷取事件通知的方法，以及覆寫 Filter Graph Manager 的預設事件處理方法。 IMediaEventEx 介面會繼承此介面並加以擴充。
Filter Graph 管理員會實作此介面。 應用程式可以使用它來響應篩選圖形中發生的事件，例如數據流結尾或轉譯錯誤。 使用 IMediaEventSink 介面篩選事件至篩選圖形。
如需事件通知的詳細資訊，請參閱 DirectShow 中的事件通知。 如需系統定義事件通知的清單，請參閱 事件通知代碼。
繼承
IMediaEvent 介面繼承自 IDispatch 介面。 IMediaEvent 也有下列類型的成員：
方法
IMediaEvent 介面具有這些方法。
| IMediaEvent：：CancelDefaultHandling CancelDefaultHandling 方法會取消篩選圖形管理員指定事件的默認處理。 事件通知會傳遞至應用程式。 |
| IMediaEvent：：FreeEventParams FreeEventParams 方法會釋放與事件參數相關聯的資源。 |
| IMediaEvent：：GetEvent GetEvent 方法會從事件佇列擷取下一個事件通知。 |
| IMediaEvent：：GetEventHandle GetEventHandle 方法會擷取手動重設事件的句柄，該事件會在佇列包含事件通知時維持訊號。 |
| IMediaEvent：：RestoreDefaultHandling RestoreDefaultHandling 方法會還原指定事件之 Filter Graph Manager 的默認處理。 |
| IMediaEvent：：WaitForCompletion WaitForCompletion 方法會等候篩選圖形轉譯所有可用的數據。 篩選圖表必須正在執行，否則方法會失敗。 |
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | control.h (包含 Dshow.h) |