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

El método SetMasterVolumeLevel establece el nivel de volumen maestro, en decibelios, de la secuencia de audio que entra o sale del dispositivo de punto de conexión de audio.

Sintaxis

HRESULT SetMasterVolumeLevel(
  [in] float   fLevelDB,
  [in] LPCGUID pguidEventContext
);

Parámetros

[in] fLevelDB

Nuevo nivel de volumen maestro en decibelios. Para obtener el intervalo y la granularidad de los niveles de volumen que puede establecer este método, llame al método IAudioEndpointVolume::GetVolumeRange .

[in] pguidEventContext

Valor de contexto del método IAudioEndpointVolumeCallback::OnNotify . Este parámetro apunta a un GUID de contexto de evento. Si la llamada SetMasterVolumeLevel 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 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 códigos de retorno posibles incluyen, entre otros, los valores que se muestran en la tabla siguiente.

Comentarios

Si el nivel de volumen fLevelDB está fuera del intervalo de volúmenes notificado por el método IAudioEndpointVolume::GetVolumeRange , se produce un error en la llamada SetMasterVolumeLevel y se devuelve el código de error E_INVALIDARG.

Requisitos

Consulte también

IAudioEndpointVolume (interfaz)

IAudioEndpointVolume::GetVolumeRange

IAudioEndpointVolumeCallback (Interfaz)

IAudioEndpointVolumeCallback::OnNotify