This method initiates a connection from this pin to the other pin.
HRESULT Connect( IPin* pReceivePin, const AM_MEDIA_TYPE* pmt );
[in] Other pin to connect to.
[in] Type to use for the connections (optional).
Returns an HRESULT value that depends on the implementation. HRESULT can be one of the following standard constants, or other values not listed.
|E_POINTER||Null pointer argument.|
|E_NOTIMPL||Method is not supported.|
|S_OK or NOERROR||Success.|
This method calls the IPin::ReceiveConnection method for the other pin. The IPin::Connect method verifies that the connection is possible and might reject it. This pin proposes a media type to the other pin.
This method is implemented in the base classes by CBasePin::Connect.
Applications should not use this method. Instead, use IFilterGraph::ConnectDirect, which will use this method. Changing connections underneath the filter graph manager can cause commands to be distributed incorrectly and can cause a deadlock.
DirectShow applications and DirectShow filters have different include file and link library requirements. See Setting Up the Build Environment for more information.
OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Last updated on Wednesday, April 13, 2005
© 2005 Microsoft Corporation. All rights reserved.