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

El método SetMasterVolumeLevelScalar establece 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 y con cinta de audio en el intervalo comprendido entre 0,0 y 1,0.

Sintaxis

HRESULT SetMasterVolumeLevelScalar(
  [in] float   fLevel,
  [in] LPCGUID pguidEventContext
);

Parámetros

[in] fLevel

Nuevo nivel de volumen maestro. El nivel se expresa como un valor normalizado en el intervalo de 0,0 a 1,0.

[in] pguidEventContext

Valor de contexto del método IAudioEndpointVolumeCallback::OnNotify . Este parámetro apunta a un GUID de contexto de evento. Si la llamada SetMasterVolumeLevelScalar cambia el nivel de volumen del punto de conexión, todos los clientes que han registrado interfaces IAudioEndpointVolumeCallback con ese punto de conexión recibirán notificaciones. En su implementación del método OnNotify , un cliente puede inspeccionar el GUID del contexto de eventos para detectar si él u otro cliente es el origen del evento de cambio de volumen. Si el autor de la llamada proporciona un puntero NULL para este parámetro, la rutina de notificación recibe el valor guid de contexto GUID_NULL.

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.

Comentarios

El nivel de volumen se normaliza hasta el intervalo comprendido entre 0,0 y 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 de audio-tapered.

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

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

Requisitos

Consulte también

IAudioEndpointVolume (interfaz)

IAudioEndpointVolumeCallback (Interfaz)

IAudioEndpointVolumeCallback::OnNotify