Metodo IAudioEndpointVolume::GetChannelVolumeLevelScalar (endpointvolume.h)

Articolo
08/23/2023

Il metodo GetChannelVolumeLevelScalar ottiene il livello di volume normalizzato e con taper audio del canale specificato del flusso audio che entra o lascia il dispositivo endpoint audio.

Sintassi

HRESULT GetChannelVolumeLevelScalar(
  [in]  UINT  nChannel,
  [out] float *pfLevel
);

Parametri

[in] nChannel

Numero di canale. Se il flusso audio contiene n canali, i canali vengono numerati da 0 a n- 1. Per ottenere il numero di canali, chiamare il metodo IAudioEndpointVolume::GetChannelCount .

[out] pfLevel

Puntatore 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
E_INVALIDARG	Il parametro nChannel è maggiore o uguale al numero di canali nel flusso.
E_POINTER	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.

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

IAudioEndpointVolume::GetChannelCount

Share via