Metodo ISpatialAudioObjectForHrtf::SetGain (spatialaudiohrtf.h)
Imposta il guadagno per ISpatialAudioObjectForHrtf in dB.
Sintassi
HRESULT SetGain(
[in] float gain
);
Parametri
[in] gain
Il guadagno per ISpatialAudioObjectForHrtf in dB.
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 SetGain. |
|
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
Questa opzione è valida solo per gli oggetti audio spaziali configurati per l'uso del tipo di decadimento SpatialAudioHrtfDistanceDecay_CustomDecay . Impostare il tipo di decadimento di un oggetto ISpatialAudioObjectForHrtf chiamando SetDistanceDecay. Impostare il tipo di decadimento predefinito per tutti gli oggetti in un flusso di rendering HRTF impostando il campo DistanceDecay di SpatialAudioHrtfActivationParams passato a ISpatialAudioClient::ActivateSpatialAudioStream.
Se SetGain non viene mai chiamato, viene usato il valore predefinito 0,0. Dopo aver chiamato SetGain , il guadagno impostato verrà usato per l'oggetto audio fino a quando il guadagno non viene modificato con un'altra chiamata a SetGain.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | spatialaudiohrtf.h |