IPin::ConnectedTo
| Microsoft DirectShow 9.0 |
IPin::ConnectedTo
The ConnectedTo method retrieves a pointer to the connected pin, if any.
Syntax
HRESULT ConnectedTo( IPin **ppPin );
Parameters
ppPin
[out] Receives a pointer to the IPin interface of the other pin. The caller must release the interface. This parameter cannot be NULL.
Return Value
Returns an HRESULT value. Possible values include the following.
| Value | Description |
| S_OK | Success. |
| E_POINTER | NULL pointer argument. |
| VFW_E_NOT_CONNECTED | Pin is not connected. |
Remarks
If the method succeeds, the IPin interface that it returns has an outstanding reference count. Be sure to release it when you are done.
Requirements
Header: Declared in Strmif.h; include Dshow.h.
Library: Use Strmiids.lib.
See Also