Microsoft DirectX 9.0


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.


HRESULT Reconnect(
  IPin *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.


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.

See Also