IMediaControl::Stop 方法 (control.h)

该方法 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