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

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

Sintaxis

HRESULT GetChannelVolume(
  [in]  UINT32 dwIndex,
  [out] float  *pfLevel
);

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 .

[out] pfLevel

Puntero a una variable float en la que el método escribe el nivel de volumen del canal especificado. El nivel de volumen está comprendido 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.
E_POINTER
El parámetro pfLevel es NULL.
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.

Comentarios

Los clientes pueden llamar al método IAudioStreamVolume::SetAllVolumes o IAudioStreamVolume::SetChannelVolume para establecer los niveles de volumen por canal en una secuencia de audio.

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

IAudioStreamVolume::SetAllVolumes

IAudioStreamVolume::SetChannelVolume