| 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.
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.
See Also