IGraphConfig：：Reconfigure 方法 (strmif.h)
[與此頁面相關的功能 DirectShow 是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對 Windows 10 和 Windows 11 進行優化。 Microsoft 強烈建議新程式代碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議使用舊版 API 的現有程式代碼盡可能重寫為使用新的 API。
方法 Reconfigure 會鎖定篩選圖形，並在應用程式中呼叫回呼函式，以執行動態重新設定。
語法
HRESULT Reconfigure(
[in] IGraphConfigCallback *pCallback,
[in] PVOID pvContext,
[in] DWORD dwFlags,
[in] HANDLE hAbortEvent
);
參數
[in] pCallback
應用程式或篩選上 IGraphConfigCallback 回 呼介面的指標。
[in] pvContext
傳遞給回呼例程之 PVOID 類型的變數指標。
[in] dwFlags
傳遞至回呼例程的應用程式定義旗標。
[in] hAbortEvent
事件的控制代碼。 如果呼叫端是其中一個數據處理線程上的篩選呼叫，這個參數應該是當篩選進入停止狀態時將發出訊號的事件句柄。 否則，此參數可以是 NULL。 如需詳細資訊，請參閱＜備註＞。
傳回值
如果成功，則傳回S_OK，否則傳回錯誤碼。 可能的錯誤包括VFW_E_WRONG_STATE，如果方法無法取得篩選圖形上的鎖定;回呼例程傳回的任何 HRESULT ;或錯誤碼，表示圖表無法將篩選條件放入執行中狀態。
備註
提供這個方法，讓應用程式或篩選條件可以實作特殊的動態圖形建置。 不過，在大部分情況下， IGraphConfig：：Reconnect 方法已足夠，因此應該優先使用，因為它會處理大部分的實作詳細數據。
呼叫此方法之前，請視需要封鎖任何數據流，並透過圖形推送數據 (請參閱 IPinFlowControl：：Block 和 IGraphConfig：:P ushThroughData) 。 如果回呼方法成功， IGraphConfig::Reconfigure 會嘗試將所有篩選條件放入執行中狀態。 (呼叫端必須解除封鎖數據流。) 否則，它會傳回方法的任何錯誤碼。
如果篩選條件在其自己的數據處理線程上呼叫此方法，它就會建立死結的可能性。 方法會取得篩選圖形上的鎖定，這可封鎖篩選在接收 IMediaFilter：：Stop 呼叫時停止篩選。 為避免這種情況，方法會接受篩選所提供之事件物件的句柄。 如果篩選收到對 Stop 方法的呼叫，篩選條件應該會發出事件訊號。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | strmif.h (包含 Dshow.h) |
| 程式庫 | Strmiids.lib |