iPinConnection 接口 (strmif.h)

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

此接口提供在筛选器仍在运行时重新连接输入引脚的方法。 Filter Graph 管理器在执行动态重新连接时调用此接口上的方法 (查看 IGraphConfig 接口) 。 应用程序还可以使用此接口执行动态引脚重新连接。

筛选器开发人员: 在允许动态重新连接或动态更改格式的任何输入引脚上实现此接口。

继承

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

方法

IPinConnection 接口具有这些方法。

 
IPinConnection::D ynamicDisconnect

当筛选器处于活动状态 (暂停或运行) 时,DynamicDisconnect 方法会断开引脚的连接。 调用此方法而不是 IPin::D isconnect,以在图形运行或暂停时断开图钉的连接。
IPinConnection::D ynamicQueryAccept

DynamicQueryAccept 方法查询图在与该引脚的当前连接运行时,引脚是否可以接受指定的媒体类型。
IPinConnection::IsEndPin

IsEndPin 方法指示重新连接搜索是否应在此固定处结束。
IPinConnection::NotifyEndOfStream

当发生下一个流结束条件时,NotifyEndOfStream 方法会从引脚请求通知。

要求

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

另请参阅

动态图形生成

动态重新连接