ISpatialAudioObjectForHrtf：：SetGain 方法 (spatialaudiohrtf.h)
在 dB 中設定 ISpatialAudioObjectForHrtf 的增益。
語法
HRESULT SetGain(
[in] float gain
);
參數
[in] gain
dB 中 ISpatialAudioObjectForHrtf 的收益。
傳回值
如果方法成功，它會傳回 S_OK。 如果失敗，可能的傳回碼包括但不限於下表所示的值。
| 傳回碼 | Description |
|---|---|
|
呼叫 SetGain 之前未呼叫 ISpatialAudioObjectRenderStreamBase：：BeginUpdatingAudioObjects。 |
|
SetEndOfStream 在先前的音訊處理階段中明確或隱含地呼叫。 如果未在音頻處理內呼叫 GetBuffer，系統就會隱含呼叫 SetEndOfStream， (ISpatialAudioObjectRenderStreamBase：：BeginUpdatingAudioObjects 和 ISpatialAudioObjectRenderStreamBase：：EndUpdatingAudioObjects) 。 |
備註
這隻適用於設定為使用 SpatialAudioHrtfDistanceDecay_CustomDecay 衰減類型的空間音頻物件。 呼叫 SetDistanceDecay 來設定 ISpatialAudioObjectForHrtf 物件的衰減類型。 設定傳遞至 ISpatialAudioClient：：ActivateSpatialAudioAudioStream 之 SpatialAudioHrtfActivationParams 的 DistanceDecay 字段，以設定 HRTF 轉譯數據流中所有對象的預設衰減類型。
如果從未呼叫 SetGain ，則會使用預設值 0.0。 呼叫 SetGain 之後，設定的增益將會用於音訊物件，直到使用另一個 對 SetGain 的呼叫變更為止。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | spatialaudiohrtf.h |