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，请调用 IMediaControl：：GetState 方法来等待状态转换完成，如果转换已完成，则调用 检查。 调用 Pause 以显示视频文件的第一帧时，请始终紧跟其后，调用 GetState 以确保状态转换已完成。 否则可能会导致视频矩形被涂成黑色。
如果方法失败，它会在返回之前停止图形。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | control.h (包括 Dshow.h) |
| Library | Strmiids.lib |