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 |
|---|---|
|
Il parametro dwCount non è uguale al numero di canali nel flusso. |
|
Il parametro pfVolumes è NULL. |
|
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. |
|
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