IFilterGraph::Reconnect

  • Article
 
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