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

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

Sintaxis

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

Parámetros

[in] dwIndex

Número de canal. Si el formato de secuencia de la sesión de audio tiene N canales, los canales se numeran de 0 a N– 1. Para obtener el número de canales, llame al método IChannelAudioVolume::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 IChannelAudioVolume::SetAllVolumes o IChannelAudioVolume::SetChannelVolume para establecer los niveles de volumen por canal en una sesión de audio.

Requisitos

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

IChannelAudioVolume (interfaz)

IChannelAudioVolume::GetChannelCount

IChannelAudioVolume::SetAllVolumes

IChannelAudioVolume::SetChannelVolume