Metodo IAudioStreamVolume::GetAllVolumes (audioclient.h)

Il metodo GetAllVolumes recupera i livelli di volume per tutti i canali nel flusso audio.

Sintassi

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

Parametri

[in] dwCount

Numero di elementi nella matrice pfVolumes . Il parametro dwCount deve essere uguale al numero di canali nel formato del flusso. Per ottenere il numero di canali, chiamare il metodo IAudioStreamVolume::GetChannelCount .

[out] pfVolumes

Puntatore a una matrice di livelli di volume per i canali nel flusso 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 sono inclusi 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 dwCount non è uguale al numero di canali nel flusso.
E_POINTER	Il parametro pfVolumes è 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