IFilterGraph::Reconnect
| Microsoft DirectShow 9.0 |
IFilterGraph::Reconnect
The Reconnect method disconnects a pin and then reconnects it to the same pin.
Applications should not call this method. It is called by filters during the graph building process.
Syntax
HRESULT Reconnect( IPin *ppin );
Parameters
ppin
[in] Pointer to IPin interface of the pin to reconnect.
Return Values
Returns one of the following values.
| Value | Description |
| S_OK | Success. |
| E_FAIL | Failure. |
| E_POINTER | Null pointer argument. |
| VFW_E_NOT_CONNECTED | Pin is not connected. |
| VFW_E_WRONG_STATE | Filter is not stopped. |
Remarks
This method is obsolete; use the IFilterGraph2::ReconnectEx method instead.
Filters can call this method in order to renegotiate a pin connection. The method executes on a separate thread. Before calling this method, call IPin::QueryAccept on the other pin to ensure that the reconnnection attempt will succeed. Do not call this method unless QueryAccept returns S_OK. Otherwise, because the reconnection is performed asynchronously, the reconnection might fail even though the Reconnect method succeeds, leaving the filter graph in an inconsistent state.
Requirements
Header: Declared in Strmif.h; include Dshow.h.
Library: Use Strmiids.lib.
See Also