通过

CDynamicOutputPin.ChangeOutputFormat 方法

  • 项目

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

方法 ChangeOutputFormat 动态更改连接的媒体类型，并提供新的段信息。 筛选器图运行时可能会发生更改。 调用此方法后，将无法传递具有旧媒体类型的示例。 调用方必须确保没有旧示例处于挂起状态。

语法

HRESULT ChangeOutputFormat(
   const AM_MEDIA_TYPE  *pmt,
         REFERENCE_TIME tSegmentStart,
         REFERENCE_TIME tSegmentStop,
         double         dSegmentRate
);

参数

Pmt

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

tSegmentStart

段的开始时间。

tSegmentStop

段的停止时间。

dSegmentRate

段速率。

返回值

返回 HRESULT 值。 可能的值包括下表中显示的值。

返回代码 说明
S_OK
 成功。
E_FAIL
 失败。 可能拥有筛选器未调用 CDynamicOutputPin：：SetConfigInfo。
VFW_E_NOT_CONNECTED
 引脚未连接。

备注

此方法在筛选器运行时更改格式类型。 如果下游引脚接受新格式，则无需重新连接。 否则， 方法将尝试重新连接引脚。 如果方法成功更改格式，它将提供新的段信息。 此方法调用 CDynamicOutputPin：：ChangeMediaType 方法来执行格式更改。

在调用此方法之前，必须调用 CDynamicOutputPin：：StartUsingOutputPin 方法。

要求

要求 值
标头
Amfilter.h (包括 Streams.h)
库
Strmbase.lib (零售版本) ;
Strmbasd.lib (调试生成)

另请参阅

CDynamicOutputPin 类