Microsoft DirectX 8.1 (C++)

IPin::Disconnect

The Disconnect method breaks the current pin connection.

Syntax

HRESULT Disconnect(void);

Return Value

Returns an HRESULT value. Possible values include the following.

Value Description
S_FALSE The pin was not connected.
S_OK Success.
VFW_E_NOT_STOPPED The filter is active.

Remarks

This method fails if the filter is paused or running. If the pin supports the IPinConnection interface, call IPinConnection::DynamicDisconnect to disconnect the pin when the filter is paused or running.

A pin should never use this method to disconnect from its peer.

See Also