Metodo IAudioStreamVolume::GetChannelVolume (audioclient.h)

Il metodo GetChannelVolume recupera il livello di volume per il canale specificato nel flusso audio.

Sintassi

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

Parametri

[in] dwIndex

Numero di canale. Se il formato del flusso ha N canali, i canali vengono numerati da 0 a N- 1. Per ottenere il numero di canali, chiamare il metodo IAudioStreamVolume::GetChannelCount .

[out] pfLevel

Puntatore a una variabile float in cui il metodo scrive il livello di volume del canale specificato. Il livello del volume è compreso 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 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 oppure 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 IAudioStreamVolume::SetAllVolumes o IAudioStreamVolume::SetChannelVolume per impostare i livelli di volume per canale in un flusso audio.

Requisiti

Requisito	Valore
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 IAudioStreamVolume

IAudioStreamVolume::GetChannelCount

IAudioStreamVolume::SetAllVolumes

IAudioStreamVolume::SetChannelVolume