Metodo IAudioEndpointVolume::GetChannelVolumeLevel (endpointvolume.h)

Il metodo GetChannelVolumeLevel ottiene il livello di volume, in decibel, del canale specificato nel flusso audio che entra o lascia il dispositivo dell'endpoint audio.

Sintassi

HRESULT GetChannelVolumeLevel(
  [in]  UINT  nChannel,
  [out] float *pfLevelDB
);

Parametri

[in] nChannel

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

[out] pfLevelDB

Puntatore a una variabile float in cui il metodo scrive il livello del volume in decibel. Per ottenere l'intervallo di livelli di volume ottenuti da questo metodo, chiamare il metodo IAudioEndpointVolume::GetVolumeRange .

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

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

IAudioEndpointVolume::GetVolumeRange