Share via

CBasePin::ConnectedTo (Compact 2013)

  • Article

3/26/2014

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

Header

dshow.h,
Streams.h

Library

ole32.lib,
Ole32auth.lib,
Strmbase.lib,
Strmiids.lib,
uuid.lib

See Also

Reference

CBasePin Class