Método ISpatialAudioObjectForHrtf::SetGain (spatialaudiohrtf.h)
Establece la ganancia para ISpatialAudioObjectForHrtf en dB.
Sintaxis
HRESULT SetGain(
[in] float gain
);
Parámetros
[in] gain
La ganancia para ISpatialAudioObjectForHrtf en dB.
Valor devuelto
Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los códigos de retorno posibles incluyen, entre otros, los valores que se muestran en la tabla siguiente.
| Código devuelto | Descripción |
|---|---|
|
No se llamó a ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects antes de la llamada a SetGain. |
|
Se llamó a SetEndOfStream de forma explícita o implícita en un paso de procesamiento de audio anterior. El sistema llama implícitamente a SetEndOfStream si no se llama a GetBuffer dentro de un paso de procesamiento de audio (entre llamadas a ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects e ISpatialAudioObjectRenderStreamBase::EndUpdatingAudioObjects). |
Comentarios
Esto solo es válido para los objetos de audio espaciales configurados para usar el tipo de SpatialAudioHrtfDistanceDecay_CustomDecay de descomposición. Establezca el tipo de decaimiento de un objeto ISpatialAudioObjectForHrtf llamando a SetDistanceDecay. Establezca el tipo de decaimiento predeterminado para todos los objetos de una secuencia de representación HRTF estableciendo el campo DistanceDecay del spatialAudioHrtfActivationParams pasado a ISpatialAudioClient::ActivateSpatialAudioStream.
Si nunca se llama a SetGain , se usa el valor predeterminado de 0,0. Después de llamar a SetGain , la ganancia que se establece se usará para el objeto de audio hasta que se cambie la ganancia con otra llamada a SetGain.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | spatialaudiohrtf.h |