IFilterGraph::ConnectDirect method (strmif.h)
[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 |
|---|---|
|
Success. |
|
NULL pointer argument. |
|
One of the specified pins is not in the 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 |