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 方法的呼叫，篩選條件應該會發出事件訊號。

規格需求

另請參閱

錯誤和成功碼

IGraphConfig 介面