IMediaControl：:P ause 方法 (control.h)

  • 项目

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

方法 Pause 暂停筛选器图中的所有筛选器。

语法

HRESULT Pause();

返回值

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

返回代码 说明
S_FALSE
 图形已成功暂停，但某些筛选器尚未完成状态转换。
S_OK
 图中的所有筛选器都完成了到暂停状态的转换。

注解

暂停筛选器图会提示图形在下次运行时立即呈现图形。 暂停图形时，筛选器会处理数据，但不呈现数据。 数据在缓冲允许的情况下通过图形推送并由转换筛选器进行处理，但呈现器筛选器不会呈现数据。 但是，视频呈现器显示第一个示例的静态海报框架。

如果方法返回S_FALSE，请调用 IMediaControl：：GetState 方法来等待状态转换完成，如果转换已完成，则调用 检查。 调用 Pause 以显示视频文件的第一帧时，请始终紧跟其后，调用 GetState 以确保状态转换已完成。 否则可能会导致视频矩形被涂成黑色。

如果方法失败，它会在返回之前停止图形。

要求

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

另请参阅

错误和成功代码

IMediaControl 接口

IMediaControl：：StopWhenReady