CBasePin::ConnectedTo
Microsoft DirectShow 9.0 |
CBasePin::ConnectedTo
The ConnectedTo method retrieves a pointer to the connected pin, if any. This method implements the IPin::ConnectedTo method.
Syntax
HRESULT ConnectedTo( IPin **ppPin );
Parameters
ppPin
Address of a variable that receives a pointer to the IPin interface of the other pin.
Return Value
Returns an HRESULT value. Possible values include those in the following table.
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 Amfilter.h; include Streams.h.
** Library:** Use Strmbase.lib (retail builds) or Strmbasd.lib (debug builds).
See Also