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

另请参阅

错误和成功代码

IMediaControl 接口

StopWhenReady