共用方式為

CTransInPlaceFilter.CompleteConnect 方法

  • 發行項

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

方法 CompleteConnect 會完成針腳連接。

語法

HRESULT CompleteConnect(
   PIN_DIRECTION direction,
   IPin          *pReceivePin
);

參數

direction

PIN_DIRECTION列舉型別的成員，指定篩選準則上的哪一個針腳正在建立連接。

pReceivePin

在此連線嘗試中，其他針腳的 IPin 介面指標。

傳回值

傳回 HRESULT。 可能的值包括下表所示的值。

傳回碼 描述
S_OK
 成功。
VFW_E_NOT_IN_GRAPH
 篩選準則不在篩選圖形中。

備註

此方法會覆寫 CTransformFilter：：CompleteConnect 方法。

篩選的行為取決於針腳連線的順序：

  • 如果先連接輸入針腳，則連接會使用暫時配置器。 連接輸出針腳時，篩選準則會重新連接輸入針腳。 重新連接輸入針腳會導致上游篩選重新交涉配置器。 此時，輸入針腳會從下游篩選建議配置器。 如需詳細資訊，請參閱 CTransInPlaceInputPin：：GetAllocator。
  • 如果先連接輸出針腳，輸出針腳就不會選取配置器。 當輸入針腳連接時，它會交涉這兩個連接的配置器。 如果輸入和輸出媒體類型不相同，篩選準則會使用輸入類型重新連接輸出針腳。

篩選準則會呼叫 CBaseFilter：：ReconnectPin 方法，以執行所有針腳重新連線。 接著，ReconnectPin方法會在篩選圖形管理員上呼叫IFilterGraph2：：ReconnectEx方法。

規格需求

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

另請參閱

CTransInPlaceFilter 類別