Condividi tramite


Interfaccia IAudioStreamVolume (audioclient.h)

L'interfaccia IAudioStreamVolume consente a un client di controllare e monitorare i livelli di volume per tutti i canali in un flusso audio. Il client ottiene un riferimento all'interfaccia IAudioStreamVolume in un oggetto di flusso chiamando il metodo IAudioClient::GetService con parametro riid impostato su REFIID IID_IAudioStreamVolume.

Il livello di volume effettivo di qualsiasi canale nella sottomix sessione, come sentito agli altoparlanti, è il prodotto dei quattro fattori a livello di volume seguenti:

  • I livelli di volume per canale dei flussi della sessione, che i client possono controllare tramite i metodi nell'interfaccia IAudioStreamVolume .
  • Livello del volume per canale della sessione, che i client possono controllare tramite i metodi nell'interfaccia IChannelAudioVolume .
  • Livello di volume master della sessione, che i client possono controllare tramite i metodi nell'interfaccia ISimpleAudioVolume .
  • Livello di volume basato su criteri della sessione, che il sistema assegna dinamicamente alla sessione come cambia la combinazione globale.
Ognuno dei quattro fattori a livello di volume nell'elenco precedente è un valore nell'intervallo da 0.0 a 1.0, dove 0.0 indica il silenzio e 1.0 indica il volume completo (nessuna attenuazione). Il livello di volume effettivo è anche un valore nell'intervallo da 0,0 a 1,0.

Quando si rilascia un'istanza dell'interfaccia IAudioStreamVolume , il client deve chiamare il metodo Release dell'interfaccia dallo stesso thread della chiamata a IAudioClient::GetService che ha creato l'oggetto.

L'interfaccia IAudioStreamVolume controlla i volumi del canale in un flusso audio in modalità condivisa. Questa interfaccia non funziona con flussi in modalità esclusiva. Per informazioni sui controlli del volume per flussi in modalità esclusiva, vedere API EndpointVolume.

Ereditarietà

L'interfaccia IAudioStreamVolume eredita dall'interfaccia IUnknown . IAudioStreamVolume include anche questi tipi di membri:

Metodi

L'interfaccia IAudioStreamVolume include questi metodi.

 
IAudioStreamVolume::GetAllVolumes

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

Il metodo GetChannelCount recupera il numero di canali nel flusso audio.
IAudioStreamVolume::GetChannelVolume

Il metodo GetChannelVolume recupera il livello di volume per il canale specificato nel flusso audio.
IAudioStreamVolume::SetAllVolumes

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

Il metodo SetChannelVolume imposta il livello del volume per il canale specificato nel flusso audio.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [app desktop | App UWP]
Server minimo supportato Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione audioclient.h

Vedi anche

Interfacce audio principali

IAudioClient::GetService

Interfaccia IChannelAudioVolume

Interfaccia ISimpleAudioVolume

WASAPI