IMediaEventEx::GetNotifyFlags 方法 (control.h)

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

方法 GetNotifyFlags 會判斷是否啟用事件通知。

語法

HRESULT GetNotifyFlags(
  [out] long *lplNoNotifyFlags
);

參數

[out] lplNoNotifyFlags

接收下列其中一個值的變數指標:

Description
零個 已啟用事件通知。
AM_MEDIAEVENT_NONOTIFY 事件通知已停用。

傳回值

如果成功,則傳回S_OK,如果 lplNoNotifyFlags 參數為 NULL,則傳回 E_POINTER。

備註

根據預設,Filter Graph 管理員會張貼應用程式的事件通知。 若要停用事件通知,請使用值AM_MEDIAEVENT_NONOTIFY呼叫 IMediaEventEx::SetNotifyFlags 方法。

如果停用事件通知, IMediaEvent::GetEventHandle 方法所傳回的句柄會在每個數據流的結尾發出訊號,也就是說,每當 Filter Graph Manager 收到 EC_COMPLETE 事件時。

規格需求

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

另請參閱

錯誤和成功碼

IMediaEventEx 介面