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