CBasePin.BreakConnect 方法

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

方法 BreakConnect 會從連接釋放針腳。

語法

virtual HRESULT BreakConnect();

參數

這個方法沒有任何參數。

傳回值

傳回S_OK。

備註

CBasePin::D isconnect方法會在針腳中斷連線期間呼叫此方法。 如果 CBasePin::CheckConnect 方法失敗,也會在連線嘗試期間呼叫它。

這個方法必須釋放 CheckConnect 方法取得的任何資源。 例如,如果 CheckConnect 配置記憶體, BreakConnect 應該釋放記憶體。 如果 CheckConnect 查詢介面的連接針腳, BreakConnect 應該釋放 介面。

請注意, BreakConnect 不需要對 CompleteConnect的對應呼叫即可呼叫。 因此,您無法假設先前已呼叫 CompleteConnect

規格需求

需求
標頭
Amfilter.h (包含 Streams.h)
程式庫
Strmbase.lib (零售組建) ;
Strmbasd.lib (偵錯組建)

另請參閱

CBasePin 類別