Metodo IChannelAudioVolume::GetAllVolumes (audioclient.h)

Il metodo GetAllVolumes recupera i livelli di volume per tutti i canali della sessione audio.

Sintassi

HRESULT GetAllVolumes(
  [in]  UINT32 dwCount,
  [out] float  *pfVolumes
);

Parametri

[in] dwCount

Numero di elementi nella matrice pfVolumes . Il parametro dwCount deve corrispondere al numero di canali nel formato di flusso per la sessione audio. Per ottenere il numero di canali, chiamare il metodo IChannelAudioVolume::GetChannelCount .

[out] pfVolumes

Puntatore a una matrice di livelli di volume per i canali nella sessione audio. Questo parametro punta a una matrice float allocata dal chiamante in cui il metodo scrive i livelli di volume per i singoli canali. I livelli di volume si trovano 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 dwCount non equivale al numero di canali nel formato di flusso per la sessione audio.
E_POINTER
Il parametro pfVolumes è 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