ISpatialAudioObjectRenderStreamBase::Stop 方法 (spatialaudioclient.h)

停止正在运行的音频流。

语法

HRESULT Stop();

返回值

如果该方法成功,则它会返回 S_OK。 如果失败,可能的返回代码包括但不限于下表中显示的值。

返回代码 说明
SPTLAUDCLNT_E_DESTROYED
与空间音频流关联的 ISpatialAudioClient 已被销毁。
AUDCLNT_E_DEVICE_INVALIDATED
音频终结点设备已拔出,或者音频硬件或关联的硬件资源已重新配置、禁用、删除或以其他方式不可用。
SPTLAUDCLNT_E_INTERNAL
发生了内部错误。
AUDCLNT_E_UNSUPPORTED_FORMAT
与空间音频流关联的媒体使用不受支持的格式。

注解

停止流会导致数据停止在终结点缓冲区和音频引擎之间流动。
可以考虑此操作暂停流,因为它将流的音频时钟保留在其当前流位置,并且不会将其重置为 0。 对 Start 的后续调用会导致流从当前位置恢复运行。
调用 Reset 将时钟位置重置为 0,并导致撤销所有活动的 ISpatialAudioObject 实例。

要求

要求
目标平台 Windows
标头 spatialaudioclient.h

另请参阅

ISpatialAudioObjectRenderStream

ISpatialAudioObjectRenderStreamBase