Metodo IChannelAudioVolume::GetChannelVolume (audioclient.h)
Il metodo GetChannelVolume recupera il livello di volume per il canale specificato nella sessione audio.
Sintassi
HRESULT GetChannelVolume(
[in] UINT32 dwIndex,
[out] float *pfLevel
);
Parametri
[in] dwIndex
Numero di canale. Se il formato di flusso per la sessione audio ha canali N , i canali vengono numerati da 0 a N- 1. Per ottenere il numero di canali, chiamare il metodo IChannelAudioVolume::GetChannelCount .
[out] pfLevel
Puntatore a una variabile float in cui il metodo scrive il livello di volume del canale specificato. Il livello del volume si trova 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 |
|---|---|
|
Il parametro dwIndex è impostato su un numero di canale non valido. |
|
Il parametro pfLevel è NULL. |
|
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. |
|
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