CBasePin::Connect (Windows CE 5.0)

Send Feedback

Initiates a connection from this pin to the other pin.

HRESULT Connect(IPin* pReceivePin,const AM_MEDIA_TYPE* pmt);

Parameters

  • pReceivePin
    Input pin to connect to.
  • pmt
    Optional media type parameter.

Return Values

Returns one of the following arguments by default; if overridden, should return standard HRESULT values.

Value Description
VFW_E_ALREADY_CONNECTED This output pin is already connected to another pin.
VFW_E_NOT_STOPPED The filter graph is not in a stopped state and connection cannot be performed.
Other error value Returned from CBasePin::AgreeMediaType or CBasePin::CheckConnect or overridden versions of these member functions.

Remarks

This member function implements the IPin::Connect method.

IPin::Connect is implemented on the output pin and calls the IPin::ReceiveConnection method for the connected input pin (implemented in the base classes as CBasePin::ReceiveConnection).

This member function calls the virtual CBasePin::CheckConnect member function, which can be overridden to verify that the connection is possible. CBasePin::CheckConnect then calls CBasePin::AgreeMediaType to negotiate a common media type with the connected pin.

CBasePin::AgreeMediaType calls CBasePin::TryMediaTypes twice, once for this pin's media type enumerator and once for the receiving pin's media type enumerator.

For each media type found, CBasePin::AttemptConnection is called, which in turn calls the receiving pin's IPin::ReceiveConnection method, and finally CBasePin::CompleteConnect if successful.

Requirements

DirectShow applications and DirectShow filters have different include file and link library requirements.

For more information, see Setting Up the Build Environment.

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header:

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.