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.
| Código devuelto | Descripción |
|---|---|
|
El parámetro fLevelDB se encuentra fuera del intervalo de volúmenes admitido por el dispositivo. |
|
Memoria insuficiente |
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
| 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::GetVolumeRange