ISpatialAudioObject：：SetVolume 方法 (spatialaudioclient.h)
設定音訊幅度乘數，將套用至 ISpatialAudioObject 所提供的音訊資料，再提交至音訊轉譯引擎。
語法
HRESULT SetVolume(
[in] float volume
);
參數
[in] volume
音訊資料的幅度乘數。 這必須是介於 0.0 和 1.0 之間的值。
傳回值
如果方法成功，它會傳回 S_OK。 如果失敗，可能的傳回碼包括但不限於下表所示的值。
| 傳回碼 | Description |
|---|---|
|
呼叫SetVolume之前，未呼叫ISpatialAudioObjectRenderStreamBase：：BeginUpdatingAudioObjects。 |
|
SetEndOfStream 在先前的音訊處理階段中明確或隱含地呼叫。 如果未在音訊處理內呼叫GetBuffer，系統就會隱含呼叫SetEndOfStream， (ISpatialAudioObjectRenderStreamBase：：BeginUpdatingAudioObjects和ISpatialAudioObjectRenderStreamBase：：EndUpdatingAudioObjects) 。 |
備註
如果從未呼叫 SetVolume ，則會使用預設值 1.0。 呼叫 SetVolume 之後，設定的音量將會用於音訊物件，直到使用另一個 SetVolume呼叫來變更音量為止。
規格需求
| 目標平台 | Windows |
| 標頭 | spatialaudioclient.h |