Metodo IAudioEndpointVolume::SetMasterVolumeLevelScalar (endpointvolume.h)
Il metodo SetMasterVolumeLevelScalar imposta il livello del volume master del flusso audio che entra o lascia il dispositivo dell'endpoint audio. Il livello del volume viene espresso come valore normalizzato, con taper audio nell'intervallo compreso tra 0,0 e 1,0.
Sintassi
HRESULT SetMasterVolumeLevelScalar(
[in] float fLevel,
[in] LPCGUID pguidEventContext
);
Parametri
[in] fLevel
Nuovo livello di volume master. Il livello viene espresso come valore normalizzato nell'intervallo compreso tra 0,0 e 1,0.
[in] pguidEventContext
Valore di contesto per il metodo IAudioEndpointVolumeCallback::OnNotify . Questo parametro punta a un GUID di contesto evento. Se la chiamata SetMasterVolumeLevelScalar modifica il livello di volume dell'endpoint, tutti i client che hanno registrato interfacce IAudioEndpointVolumeCallback con tale endpoint riceveranno notifiche. Nell'implementazione del metodo OnNotify , un client può controllare il GUID del contesto evento per individuare se è l'origine dell'evento di modifica del volume o di un altro client. Se il chiamante fornisce un puntatore NULL per questo parametro, la routine di notifica riceve il valore GUID di contesto GUID_NULL.
Valore restituito
Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i codici restituiti possibili includono, ma non sono limitati a, i valori visualizzati nella tabella seguente.
| Codice restituito | Descrizione |
|---|---|
|
Il parametro fLevel non è compreso nell'intervallo compreso tra 0,0 e 1,0. |
|
Memoria insufficiente. |
Commenti
Il livello del volume è normalizzato all'intervallo compreso tra 0,0 e 1,0, dove 0,0 è il livello minimo del volume e 1.0 è il livello massimo. All'interno di questo intervallo, la relazione del livello di volume normalizzato all'attenuazione dell'ampiezza del segnale è descritta da una curva non lineare, audio-tapered. Si noti che la forma della curva potrebbe cambiare nelle versioni future di Windows. Per altre informazioni sulle curve con taper audio, vedere Controlli volume con tocco audio.
I livelli di volume normalizzati passati a questo metodo sono adatti per rappresentare le posizioni dei controlli del volume nelle finestre dell'applicazione e nella schermata.
Per un esempio di codice che chiama SetMasterVolumeLevelScalar, vedere Controlli volume endpoint.
Requisiti
| Client minimo supportato | Windows Vista [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2008 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | endpointvolume.h |
Vedi anche
Interfaccia IAudioEndpointVolume