IPin::ConnectedTo method

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

Syntax


HRESULT ConnectedTo(
  [out]  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.

Return codeDescription
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]

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

 

 

Community Additions

ADD
Show:
© 2014 Microsoft