IGraphConfig 介面 (strmif.h)

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

Filter Graph 管理員會 IGraphConfig 公開以支援動態圖表建置。 此介面可讓應用程式和篩選在圖形處於執行中狀態時重新設定篩選圖形，而不會遺失數據流中的數據。

以動態方式重建圖形的最簡單方式是呼叫 IGraphConfig：：Reconnect 方法。 這個方法會處理動態重建圖形的大部分詳細數據。 如果發生您想要實作自己的技術的情況， IGraphConfig 也提供 IGraphConfig：：Reconfigure 方法。 此方法會取得篩選圖形的鎖定，然後在應用程式中呼叫回呼函式，以重新設定圖形。 使用此方法時，大部分的工作都會轉移至您的應用程式。 如需詳細資訊，請參閱 動態圖形建置。

為了優化新增和移除篩選的程式，篩選圖表會維護篩選條件的快取。 在重新 連線方法的 呼叫期間，您可以指定從圖形中移除的任何篩選都會新增至快取。 您也可以藉由呼叫 IGraphConfig：：AddFilterToCache，直接將篩選新增至快取。 IGraphBuilder：：Render、IGraphBuilder：：RenderFile 和 IGraphBuilder：：Connect 方法會自動嘗試在快取中使用篩選，再使用其他篩選。 此外，在 [重新連線 ] 方法中，您可以指定只會使用快取的篩選條件來進行重新連線。 請注意，快取中保留的篩選實際上不是圖形的一部分。 它們會中斷與任何針腳的連線，並處於停止狀態。

繼承

IGraphConfig 介面繼承自 IUnknown 介面。 IGraphConfig 也有下列類型的成員：

方法

IGraphConfig 介面具有這些方法。

IGraphConfig：：AddFilterToCache AddFilterToCache 方法會將篩選新增至篩選快取。
IGraphConfig：：EnumCacheFilter EnumCacheFilter 方法會列舉篩選快取中的篩選。
IGraphConfig：：GetFilterFlags GetFilterFlags 方法會擷取篩選條件的組態資訊。
IGraphConfig：：GetStartTime GetStartTime 方法會擷取上次將篩選圖表放入執行中狀態時所使用的參考時間。
IGraphConfig：:P ushThroughData PushThroughData 方法會將數據透過篩選圖形推送至指定的針腳。
IGraphConfig：：Reconfigure Reconfigure 方法會鎖定篩選圖形，並在應用程式或篩選中呼叫回呼函式，以執行動態重新設定。
IGraphConfig：：Reconnect 重新連線方法會在兩個針腳之間執行動態重新連線。
IGraphConfig：：RemoveFilterEx RemoveFilterEx 方法會從篩選圖形中移除篩選。
IGraphConfig：：RemoveFilterFromCache RemoveFilterFromCache 方法會從篩選快取中移除篩選條件。
IGraphConfig：：SetFilterFlags SetFilterFlags 方法會設定篩選條件的組態資訊。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	strmif.h (包含 Dshow.h)