Método IAudioEndpointVolume::GetChannelVolumeLevel (endpointvolume.h)

  • Artículo

El método GetChannelVolumeLevel obtiene el nivel de volumen, en decibelios, del canal especificado en la secuencia de audio que entra o sale del dispositivo de punto de conexión de audio.

Sintaxis

HRESULT GetChannelVolumeLevel(
  [in]  UINT  nChannel,
  [out] float *pfLevelDB
);

Parámetros

[in] nChannel

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

[out] pfLevelDB

Puntero a una variable float en la que el método escribe el nivel de volumen en decibelios. Para obtener el intervalo de niveles de volumen obtenidos de este método, llame al método IAudioEndpointVolume::GetVolumeRange .

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 nChannel es mayor o igual que el número de canales de la secuencia.
E_POINTER
 El parámetro pfLevelDB es NULL.

Requisitos

   
Cliente mínimo compatible Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado endpointvolume.h

Consulte también

IAudioEndpointVolume (interfaz)

IAudioEndpointVolume::GetChannelCount

IAudioEndpointVolume::GetVolumeRange