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

El método GetChannelVolumeLevelScalar obtiene el nivel de volumen normalizado y con cinta de audio del canal especificado de la secuencia de audio que entra o sale del dispositivo de punto de conexión de audio.

Sintaxis

HRESULT GetChannelVolumeLevelScalar(
  [in]  UINT  nChannel,
  [out] float *pfLevel
);

Parámetros

[in] nChannel

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

[out] pfLevel

Puntero a una variable float en la que el método escribe el nivel de volumen. El nivel se expresa como un valor normalizado en el intervalo de 0,0 a 1,0.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los códigos de retorno posibles incluyen, entre otros, los valores que se muestran en la tabla siguiente.

Comentarios

El nivel de volumen se normaliza hasta el intervalo de 0,0 a 1,0, donde 0,0 es el nivel de volumen mínimo y 1,0 es el nivel máximo. Dentro de este intervalo, la relación del nivel de volumen normalizado con la atenuación de la amplitud de señal se describe mediante una curva no lineal y con cinta de audio. Tenga en cuenta que la forma de la curva puede cambiar en versiones futuras de Windows. Para obtener más información sobre las curvas con cinta de audio, vea Controles de volumen con cinta de audio.

Los niveles de volumen normalizados recuperados por este método son adecuados para representar las posiciones de los controles de volumen en las ventanas de aplicación y las pantallas en pantalla.

Requisitos

Consulte también

IAudioEndpointVolume (interfaz)

IAudioEndpointVolume::GetChannelCount