Condividi tramite


Interfaccia ISimpleAudioVolume (audioclient.h)

L'interfaccia ISimpleAudioVolume consente a un client di controllare il livello del volume master di una sessione audio. Il metodo IAudioClient::Initialize inizializza un oggetto stream e assegna il flusso a una sessione audio. Il client ottiene un riferimento all'interfaccia ISimpleAudioVolume in un oggetto di flusso chiamando il metodo IAudioClient::GetService con il parametro riid impostato su REFIID IID_ISimpleAudioVolume.

In alternativa, un client può ottenere l'interfaccia ISimpleAudioVolume di una sessione esistente senza dover prima creare un oggetto di flusso e aggiungere il flusso alla sessione. Il client chiama invece il metodo IAudioSessionManager::GetSimpleAudioVolume con il GUID della sessione.

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 di volume master della sessione, che i client possono controllare tramite i metodi nell'interfaccia ISimpleAudioVolume .
  • Livello del volume per canale della sessione, che i client possono controllare tramite i metodi nell'interfaccia IChannelAudioVolume .
  • 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.

Le applicazioni audio tipiche non modificano i livelli di volume delle sessioni. Si basano invece sugli utenti per impostare questi livelli di volume tramite il programma Sndvol. Sndvol modifica solo i livelli di volume master delle sessioni. Per impostazione predefinita, gestione sessione imposta il livello del volume master su 1.0 all'attivazione iniziale di una sessione. Le modifiche successive del volume da Sndvol o altri client sono persistenti tra i riavvii del computer.

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

L'interfaccia ISimpleAudioVolume controlla il volume di una sessione audio. Una sessione audio è una raccolta di flussi 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 ISimpleAudioVolume eredita dall'interfaccia IUnknown . ISimpleAudioVolume include anche questi tipi di membri:

Metodi

L'interfaccia ISimpleAudioVolume include questi metodi.

 
ISimpleAudioVolume::GetMasterVolume

Il metodo GetMasterVolume recupera il livello del volume client per la sessione audio.
ISimpleAudioVolume::GetMute

Il metodo GetMute recupera lo stato di modifica corrente per la sessione audio.
ISimpleAudioVolume::SetMasterVolume

Il metodo SetMasterVolume imposta il livello del volume master per la sessione audio.
ISimpleAudioVolume::SetMute

Il metodo SetMute imposta lo stato di modifica per la sessione 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

IAudioClient::Initialize

Interfaccia IAudioStreamVolume

Interfaccia IChannelAudioVolume

WASAPI