MSDC 4.3 接口规范（8）

4.4.3停止流媒体服务

4.4.3.1 接口功能

4.4.3.2 先决条件

流模块连接初始化成功

4.4.3.3 描述

要停止处于STARTED或STALLED状态的流服务，应用程序应使用stopStreamingService（）。通过调用此函数，应用程序提供要停止的服务的服务ID。

如果停止流式处理服务成功，MSDC API将使用streamingServiceStopped（）进行响应，以指示服务已移至STOPPED状态。

有关代码示例，请参见第A.3.2节。

4.4.3.4 调用流程

4.4.3.4.1 停止流服务

要停止处于STARTED或STALLED状态的服务，应用程序使用stopStreamingService()。如果停止服务成功，MSDC API将向应用程序发送streamingServiceStopped()

4.4.3.4.3 无法停止流服务

如果MSDC由于某种原因无法停止流媒体服务，MSDC API将使用
streamingServiceError()和错误代码error_S_UNABLE_TO_STOP_SERVICE。

4.4.4 切换流服务

4.4.4.1 接口

4.4.4.2 前置条件

• 开启了流服务初始化连接
• S1 服务已经启动

4.4.4.3 描述

当应用程序希望从一个服务切换到另一个服务时，可以使用switchStreamingService()，例如:

S1到S2。通过这个调用，应用程序提供两个服务的服务ID。

如果服务切换成功，MSDC API将对S1使用streamingServiceStopped()，对S2使用streemingServiceStarted()。这表明S1已移动到STOPPED状态，而S2已移动至STARTED状态。

注意：当应用程序使用switchStreamingService()时，可以从MSDC以任何顺序发送streamingServiceStopped()和streaming ServiceStarted()通知。

有关代码示例，请参见第A.3.3节。

4.4.4.4 调用流程