IPinConnection::DynamicDisconnect

 
Microsoft DirectShow 9.0

IPinConnection::DynamicDisconnect

The DynamicDisconnect method disconnects the pin when the filter is active (paused or running). Call this method instead of IPin::Disconnect to disconnect a pin when the graph is running or paused.

The caller must ensure that no data is flowing to the pin when it calls this method. Call the IPinFlowControl::Block method on an upstream pin to block the data flow, or use some other mechanism to make sure that no samples are delivered until this pin is reconnected.

Syntax

  HRESULT DynamicDisconnect(void);

Return Value

Returns an HRESULT value. Possible values include the following.

Value Description
S_FALSE The pin is already disconnected.
S_OK Success.

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also