Compartir a través de

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

  • Artículo

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

Sintaxis

HRESULT SetChannelVolumeLevelScalar(
  [in] UINT    nChannel,
  [in] float   fLevel,
  [in] LPCGUID pguidEventContext
);

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 .

[in] fLevel

Nivel de volumen. El nivel de volumen 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 a SetChannelVolumeLevelScalar 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 en el método, 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; o el parámetro fLevel está fuera del intervalo comprendido entre 0,0 y 1,0.
E_OUTOFMEMORY
 Memoria insuficiente

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.

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)

IAudioEndpointVolume::GetChannelCount

IAudioEndpointVolumeCallback (Interfaz)

IAudioEndpointVolumeCallback::OnNotify