IPinConnection::D ynamicQueryAccept 方法 (strmif.h)

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

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

语法

HRESULT DynamicQueryAccept(
  [in] const AM_MEDIA_TYPE *pmt
);

参数

[in] pmt

指向指定媒体类型的 AM_MEDIA_TYPE 结构的指针。

返回值

返回 HRESULT 值。 可能的值包括以下值。

返回代码 说明
S_OK
媒体类型是可接受的。
VFW_E_TYPE_NOT_ACCEPTED
不接受媒体类型。

注解

如果此方法成功,则引脚可以在下一个示例或 IPin::ReceiveConnection 调用中接受媒体类型。

应用程序或筛选器可以调用此方法,以确定是否必须重新配置筛选器图。 如果引脚可以接受指定的媒体类型,则无需重新配置图形。

尽管 IPin::QueryAccept 方法还确定引脚是否可以接受格式类型,但它并不能保证在筛选器运行时引脚可以切换到该格式。 如果需要在筛选器运行时切换格式,请改为调用 DynamicQueryAccept

要求

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

另请参阅

动态格式更改

错误和成功代码

IPinConnection 接口