Metodo IAudioEndpointVolume::GetMasterVolumeLevelScalar (endpointvolume.h)
Il metodo GetMasterVolumeLevelScalar ottiene il livello di volume master del flusso audio che entra o lascia il dispositivo dell'endpoint audio. Il livello del volume viene espresso come valore normalizzato e con taper audio nell'intervallo compreso tra 0,0 e 1,0.
Sintassi
HRESULT GetMasterVolumeLevelScalar(
[out] float *pfLevel
);
Parametri
[out] pfLevel
Puntatore al livello del volume master. Questo parametro punta a una variabile float in cui il metodo scrive il livello del volume. Il livello viene espresso come valore normalizzato nell'intervallo compreso tra 0,0 e 1,0.
Valore restituito
Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i possibili codici restituiti includono, ma non sono limitati, i valori illustrati nella tabella seguente.
| Codice restituito | Descrizione |
|---|---|
|
Il parametro pfLevel è NULL. |
Commenti
Il livello del volume viene normalizzato nell'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 tra il livello del volume normalizzato e l'attenuazione dell'ampiezza del segnale è descritta da una curva non lineare e audio-tapered. Si noti che la forma della curva potrebbe cambiare nelle versioni future di Windows. Per altre informazioni sulle curve audio tapered, vedi Controlli volume con tocco audio.
I livelli di volume normalizzati recuperati da questo metodo sono adatti a rappresentare le posizioni dei controlli del volume nelle finestre dell'applicazione e nelle visualizzazioni sullo schermo.
Per un esempio di codice che chiama GetMasterVolumeLevelScalar, vedere Controlli del volume degli endpoint.
Requisiti
| Requisito | Valore |
|---|---|
| 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 |