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