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 |