IMediaControl：：Stop 方法 (control.h)
[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayer、 IMFMediaEngine 和 音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
方法 Stop 停止图形中的所有筛选器。
语法
HRESULT Stop();
返回值
如果成功，则返回S_OK，或返回指示错误原因的 HRESULT 值。
注解
如果图形正在运行，此方法在停止关系图之前会暂停它。 暂停时，视频呈现器可以复制当前帧以海报帧的形式显示。
此方法不查找流的开头。 如果调用此方法，然后调用 IMediaControl：：Run 方法，则播放将从停止的位置恢复。 若要查找，请使用 IMediaSeeking 接口。
Filter Graph 管理器暂停图形中的所有筛选器，然后对所有筛选器调用 IMediaFilter：：Stop 方法，而无需等待暂停操作完成。 因此，某些筛选器可能在完成暂停操作之前调用其 Stop 方法。 如果开发自定义呈现筛选器，则在筛选器处于运行状态时收到停止命令时，可能需要通过暂停筛选器来处理这种情况。 但是，大多数筛选器不需要在这方面采取任何特殊操作。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | control.h (包括 Dshow.h) |
| Library | Strmiids.lib |