Edit

CTransformFilter.BreakConnect method

  • Article

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The BreakConnect method releases a pin from a connection.

Syntax

virtual HRESULT BreakConnect(
   PIN_DIRECTION dir
);

Parameters

dir

Member of the PIN_DIRECTION enumerated type, specifying which pin connection was broken (input or output).

Return value

Returns S_OK.

Remarks

The CTransformInputPin::BreakConnect and CTransformOutputPin::BreakConnect methods call this method when a pin connection is broken. This method does nothing in the base class. If you override the CheckConnect method, override this method to release any resources obtained in the CheckConnect method, including interface pointers.

Requirements

Requirement Value
Header
Transfrm.h (include Streams.h)
Library
Strmbase.lib (retail builds);
Strmbasd.lib (debug builds)

See also

CTransformFilter Class