CBasePin.BreakConnect method

The BreakConnect method releases the pin from a connection.


virtual HRESULT BreakConnect();


This method has no parameters.

Return value

Returns S_OK.


This method is called during pin disconnection by the CBasePin::Disconnect method. It is also called during a connection attempt if the CBasePin::CheckConnect method fails.

This method must free any resources that were obtained by the CheckConnect method. For example, if CheckConnect allocates memory, BreakConnect should free the memory. If CheckConnect queries the connecting pin for an interface, BreakConnect should free the interface.

Note that BreakConnect can be called without a corresponding call to CompleteConnect. Therefore, you cannot assume that CompleteConnect has been called previously.


Requirement Value
Amfilter.h (include Streams.h)
Strmbase.lib (retail builds);
Strmbasd.lib (debug builds)

See also

CBasePin Class