Share via


CBasePin::ConnectedTo

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Retrieves a pointer to the connected pin, if there is one.

Syntax

HRESULT ConnectedTo(
  IPin** ppPin
);

Parameters

  • ppPin
    IPin interface of the other pin (if any) that this pin is connected to.

Return Value

The base class returns S_OK if connected; otherwise, returns VFW_E_NOT_CONNECTED.

Remarks

This member function implements the IPin::ConnectedTo method.

It adds a reference to the connected IPin interface by calling the IUnknown::AddRef method, because each copy of an interface pointer has its reference incremented.

The calling application is responsible for calling IUnknown::Release on this interface when done with it.

Requirements

Windows Embedded CE Windows CE 2.12 and later
Windows Mobile Windows Mobile Version 5.0 and later
Note Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements
For more information, see Setting Up the Build Environment, Version 2.12 requires DXPAK 1.0 or later