Metodo IAudioStreamVolume::SetAllVolumes (audioclient.h)

Articolo
02/28/2024

Il metodo SetAllVolumes imposta i singoli livelli di volume per tutti i canali nel flusso audio.

Sintassi

HRESULT SetAllVolumes(
  [in] UINT32      dwCount,
  [in] const float *pfVolumes
);

Parametri

[in] dwCount

Numero di elementi nella matrice pfVolumes . Questo parametro deve corrispondere al numero di canali nel formato di flusso. Per ottenere il numero di canali, chiamare il metodo IAudioStreamVolume::GetChannelCount .

[in] pfVolumes

Puntatore a una matrice di livelli di volume per i canali nel flusso audio. Il numero di elementi nella matrice pfVolumes viene specificato dal parametro dwCount . Il chiamante scrive il livello del volume per ogni canale nell'elemento matrice il cui indice corrisponde al numero di canale. Se il formato di flusso ha canali N , i canali vengono numerati da 0 a N- 1. I livelli di volume validi 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 è uguale al numero di canali nel flusso o il valore di un elemento matrice pfVolumes non si trova nell'intervallo 0.0 a 1.0.
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.

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

Condividi tramite