IPin 接口 (strmif.h)

[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayer、 IMFMediaEngine 和 音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

此接口由所有输入和输出引脚公开。

筛选器图管理器使用此接口来连接引脚并执行刷新操作。 应用程序可以使用此接口来查询固定信息。 应用程序不应调用 IPin 更改引脚状态的方法，例如 Connect、 Disconnect、 BeginFlush 或 EndFlush。 若要连接引脚，应用程序必须使用 IGraphBuilder 中的 方法。

筛选器开发人员： CBasePin、CBaseInputPin 和 CBaseOutputPin 类实现此接口。 其他基类派生自这三个类。

继承

IPin 接口继承自 IUnknown 接口。 IPin 还具有以下类型的成员：

方法

IPin 接口具有这些方法。

IPin：：BeginFlush BeginFlush 方法开始刷新操作。 (IPin.BeginFlush)
IPin：：Connect Connect 方法将引脚连接到另一个引脚。
IPin：：ConnectedTo ConnectedTo 方法检索指向连接的引脚的指针（如果有）。
IPin：：ConnectionMediaType ConnectionMediaType 方法检索当前引脚连接的媒体类型（如果有）。
IPin：:D isconnect Disconnect 方法断开当前引脚连接。
IPin：：EndFlush EndFlush 方法结束刷新操作。 (IPin.EndFlush)
IPin：：EndOfStream 在向筛选器发出新的 run 命令之前，EndOfStream 方法会通知引脚不需要其他数据。
IPin：：EnumMediaTypes EnumMediaTypes 方法枚举引脚的首选媒体类型。
IPin：：NewSegment NewSegment 方法通知引脚，在此调用后收到的媒体样本分组为一个段，并具有通用的开始时间、停止时间和速率。
IPin：：QueryAccept QueryAccept 方法确定引脚是否接受指定的媒体类型。
IPin：：QueryDirection QueryDirection 方法获取输入或输出) (引脚的方向。
IPin：：QueryId QueryId 方法检索引脚的标识符。
IPin：：QueryInternalConnections QueryInternalConnections 方法检索在筛选器) 内部连接到此引脚 (的引脚。
IPin：：QueryPinInfo QueryPinInfo 方法检索有关固定的信息。
IPin：：ReceiveConnection ReceiveConnection 方法接受来自另一个引脚的连接。

要求

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