Método ISpatialAudioObject::SetVolume (spatialaudioclient.h)
Establece un multiplicador de amplitud de audio que se aplicará a los datos de audio proporcionados por ISpatialAudioObject antes de enviarlos al motor de representación de audio.
Sintaxis
HRESULT SetVolume(
[in] float volume
);
Parámetros
[in] volume
Multiplicador de amplitud para los datos de audio. Debe ser un valor entre 0,0 y 1,0.
Valor devuelto
Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los posibles códigos de retorno incluyen, pero no están limitados a, 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 SetVolume. |
|
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
Si nunca se llama a SetVolume , se usa el valor predeterminado de 1.0. Después de llamar a SetVolume , el volumen que se establece se usará para el objeto de audio hasta que el volumen se cambie con otra llamada a SetVolume.
Requisitos
| Plataforma de destino | Windows |
| Encabezado | spatialaudioclient.h |