Método IAudioStreamVolume::SetChannelVolume (audioclient.h)

Artículo
02/23/2024

El método SetChannelVolume establece el nivel de volumen del canal especificado en la secuencia de audio.

Sintaxis

HRESULT SetChannelVolume(
  [in] UINT32      dwIndex,
  [in] const float fLevel
);

Parámetros

[in] dwIndex

Número de canal. Si el formato de secuencia tiene N canales, los canales se numeran de 0 a N– 1. Para obtener el número de canales, llame al método IAudioStreamVolume::GetChannelCount .

[in] fLevel

Nivel de volumen del canal. Los niveles de volumen válidos están comprendidos 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
E_INVALIDARG	El parámetro dwIndex se establece en un número de canal no válido o el parámetro fLevel no está en el intervalo de 0,0 a 1,0.
AUDCLNT_E_DEVICE_INVALIDATED	El dispositivo de punto de conexión de audio se ha desconectado o el hardware de audio o los recursos de hardware asociados se han reconfigurado, deshabilitado, quitado o no están disponibles para su uso.
AUDCLNT_E_SERVICE_NOT_RUNNING	El servicio de audio de Windows no se está ejecutando.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	audioclient.h

Consulte también

IAudioStreamVolume (interfaz)

IAudioStreamVolume::GetChannelCount