IPin::ConnectedTo method

The ConnectedTo method retrieves a pointer to the connected pin, if any.

Syntax

HRESULT ConnectedTo(
  IPin **pPin
);

Parameters

pPin

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.

Return code 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

   
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header strmif.h (include Dshow.h)
Library Strmiids.lib

See Also

Data Flow in the Filter Graph

Error and Success Codes

Find an Unconnected Pin on a Filter

IPin Interface