ISpatialAudioObjectRenderStreamBase::Stop 方法 (spatialaudioclient.h)
停止執行中的音訊數據流。
Syntax
HRESULT Stop();
傳回值
如果方法成功,它會傳回 S_OK。 如果失敗,可能的傳回碼包括,但不限於下表所示的值。
傳回碼 | Description |
---|---|
|
與空間音頻數據流相關聯的 ISpatialAudioClient 已終結。 |
|
音訊端點裝置已解除叢集,或音訊硬體或相關聯的硬體資源已重新設定、停用、移除,否則無法使用。 |
|
發生內部錯誤。 |
|
與空間音訊數據流相關聯的媒體會使用不支援的格式。 |
備註
停止數據流會導致數據停止在端點緩衝區與音訊引擎之間流動。
您可以考慮此作業暫停數據流,因為它將數據流的音訊時鐘保留在目前的數據流位置,而且不會將其重設為 0。 後續呼叫 Start 會導致數據流從目前位置繼續執行。
呼叫 Reset 將時鐘位置重設為 0,並導致撤銷所有作用中的 ISpatialAudioObject 實例。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | spatialaudioclient.h |