Compartir a través de

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

  • Artículo

El método GetMasterVolumeLevelScalar obtiene el nivel de volumen maestro de la secuencia de audio que entra o sale del dispositivo de punto de conexión de audio. El nivel de volumen se expresa como un valor normalizado con cinta de audio en el intervalo de 0,0 a 1,0.

Sintaxis

HRESULT GetMasterVolumeLevelScalar(
  [out] float *pfLevel
);

Parámetros

[out] pfLevel

Puntero al nivel de volumen maestro. Este parámetro apunta 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.

Código devuelto Descripción
E_POINTER
 El parámetro pfLevel es NULL.

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.

Para obtener un ejemplo de código que llama a GetMasterVolumeLevelScalar, consulte Controles de volumen de puntos de conexión.

Requisitos

Requisito Value
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)