IFilterGraph::ConnectDirect 方法 (strmif.h)

[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayerIMFMediaEngine媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayerIMFMediaEngineMedia Foundation 中的音频/视频捕获 ,而不是 DirectShow。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

方法 ConnectDirect 将两个引脚直接 (连接,而无需干预筛选器) 。

语法

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

参数

[in] ppinOut

指向输出引脚的指针。

[in] ppinIn

指向输入引脚的指针。

[in] pmt

指向用于连接的媒体类型的指针 (可选;可以为 NULL) 。

返回值

返回以下值之一,或 IPin::Connect 返回的错误值。

返回代码 说明
S_OK
成功。
E_POINTER
NULL 指针参数。
VFW_E_NOT_IN_GRAPH
其中一个指定的引脚不在图中。
VFW_E_CIRCULAR_GRAPH
输入引脚与输出引脚上游,这将导致圆形图形。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 strmif.h (包括 Dshow.h)
Library Strmiids.lib

另请参阅

错误和成功代码

IFilterGraph 接口