IFilterGraph::Disconnect

 
Microsoft DirectShow 9.0

IFilterGraph::Disconnect

The Disconnect method disconnects this pin.

Syntax

  HRESULT Disconnect(
  IPin *ppin
);

Parameters

ppin

[in] Pointer to the pin to disconnect.

Return Values

Returns one of the following values.

Value Description
S_OK Success.
S_FALSE Pin was not connected. No error.
E_FAIL Failure.
E_POINTER Null pointer argument.
VFW_E_NOT_STOPPED The filter is not stopped, but does not support reconnection while in a running state.

Remarks

This method does not completely break the connection. To completely break the connection, both ends must be disconnected.

To remove a filter from the filter graph entirely, call the IFilterGraph::RemoveFilter method.

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also