Edit

IFilterGraph::ConnectDirect method (strmif.h)

  • Article

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The ConnectDirect method connects the two pins directly (without intervening filters).

Syntax

HRESULT ConnectDirect(
  [in] IPin                *ppinOut,
  [in] IPin                *ppinIn,
  [in] const AM_MEDIA_TYPE *pmt
);

Parameters

[in] ppinOut

Pointer to the output pin.

[in] ppinIn

Pointer to the input pin.

[in] pmt

Pointer to the media type to use for the connection (optional; can be NULL).

Return value

Returns one of the following values, or an error value returned by IPin::Connect.

Return code Description
S_OK
 Success.
E_POINTER
 NULL pointer argument.
VFW_E_NOT_IN_GRAPH
 One of the specified pins is not in the graph.
VFW_E_CIRCULAR_GRAPH
 The input pin is upstream of the output pin, which would result in a circular graph.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header strmif.h (include Dshow.h)
Library Strmiids.lib

See also

Error and Success Codes

IFilterGraph Interface