IDistributorNotify::NotifyGraphChange 方法 (strmif.h)
[與此頁面 相關的功能 DirectShow 是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對 Windows 10 和 Windows 11 進行優化。 Microsoft 強烈建議新程式代碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ,而不是 DirectShow。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式代碼,以使用新的 API。]
NotifyGraphChange
當篩選圖形中的篩選集變更或任何釘選連接變更時,就會呼叫 方法。
Syntax
HRESULT NotifyGraphChange();
傳回值
傳回 HRESULT 值。
備註
每當呼叫 IFilterGraph::AddFilter、 IFilterGraph::RemoveFilter 或 IFilterGraph::ConnectDirect 方法或呼叫方法時,就會呼叫此方法,這會導致其中一個呼叫 (例如 IGraphBuilder::RenderFile) 。
請確定您在此時間點已移除的任何保留篩選上呼叫 Release 。 基於效能考慮,在 PID 實際需要介面之前,PID 可能會選擇不要重新掃描篩選,因為可能會傳送數個不同的通知。 不過,請務必立即釋放任何快取的介面。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | strmif.h (包含 Dshow.h) |
程式庫 | Strmiids.lib |