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 |
|---|---|
|
Il parametro dwIndex è impostato su un numero di canale non valido. |
|
Il parametro pfLevel è 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