Metodo IChannelAudioVolume::GetChannelVolume (audioclient.h)

Il metodo GetChannelVolume recupera il livello di volume per il canale specificato nella sessione audio.

Sintassi

HRESULT GetChannelVolume(
  [in]  UINT32 dwIndex,
  [out] float  *pfLevel
);

Parametri

[in] dwIndex

Numero di canale. Se il formato di flusso per la sessione audio ha canali N , i canali vengono numerati da 0 a N- 1. Per ottenere il numero di canali, chiamare il metodo IChannelAudioVolume::GetChannelCount .

[out] pfLevel

Puntatore a una variabile float in cui il metodo scrive il livello di volume del canale specificato. Il livello del volume si trova nell'intervallo da 0,0 a 1,0.

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 dwIndex è impostato su un numero di canale non valido.
E_POINTER	Il parametro pfLevel è NULL.
AUDCLNT_E_DEVICE_INVALIDATED	Il dispositivo endpoint audio è stato scollegato o l'hardware audio o le risorse hardware associate sono state riconfigurate, disabilitate, rimosse o altrimenti non disponibili per l'uso.
AUDCLNT_E_SERVICE_NOT_RUNNING	Il servizio audio Di Windows non è in esecuzione.

Commenti

I client possono chiamare il metodo IChannelAudioVolume::SetAllVolumes o IChannelAudioVolume::SetChannelVolume per impostare i livelli di volume per canale in una sessione audio.

Requisiti

Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	audioclient.h

Vedi anche

Interfaccia IChannelAudioVolume

IChannelAudioVolume::GetChannelCount

IChannelAudioVolume::SetAllVolumes

IChannelAudioVolume::SetChannelVolume