Metodo ISpatialAudioObject::SetVolume (spatialaudioclient.h)
Imposta un moltiplicatore di ampiezza audio che verrà applicato ai dati audio forniti da ISpatialAudioObject prima che venga inviato al motore di rendering audio.
Sintassi
HRESULT SetVolume(
[in] float volume
);
Parametri
[in] volume
Moltiplicatore di ampiezza per i dati audio. Deve essere un valore compreso tra 0,0 e 1,0.
Valore restituito
Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i possibili codici restituiti includono, ma non sono limitati, i valori illustrati nella tabella seguente.
| Codice restituito | Descrizione |
|---|---|
|
ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects non è stato chiamato prima della chiamata a SetVolume. |
|
SetEndOfStream è stato chiamato in modo esplicito o implicito in un passaggio di elaborazione audio precedente. SetEndOfStream viene chiamato in modo implicito dal sistema se GetBuffer non viene chiamato all'interno di un passaggio di elaborazione audio (tra le chiamate a ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects e ISpatialAudioObjectRenderStreamBase::EndUpdatingAudioObjects). |
Commenti
Se SetVolume non viene mai chiamato, viene usato il valore predefinito 1,0. Dopo la chiamata a SetVolume , il volume impostato verrà usato per l'oggetto audio fino a quando il volume non viene modificato con un'altra chiamata a SetVolume.
Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | spatialaudioclient.h |