Interfaccia IAudioSessionControl (audiopolicy.h)

L'interfaccia IAudioSessionControl consente a un client di configurare i parametri di controllo per una sessione audio e di monitorare gli eventi nella sessione. Il metodo IAudioClient::Initialize inizializza un oggetto flusso e assegna il flusso a una sessione audio. Il client ottiene un riferimento all'interfaccia IAudioSessionControl in un oggetto flusso chiamando il metodo IAudioClient::GetService con il parametro riid impostato su REFIID IID_IAudioSessionControl.

In alternativa, un client può ottenere l'interfaccia IAudioSessionControl di una sessione esistente senza dover prima creare un oggetto flusso e aggiungere il flusso alla sessione. Il client chiama invece il metodo IAudioSessionManager::GetAudioSessionControl con il parametro AudioSessionGuid impostato sul GUID di sessione.

Il client può registrarsi per ricevere la notifica dal gestore sessione quando i client modificano i parametri di sessione tramite i metodi nell'interfaccia IAudioSessionControl .

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

L'interfaccia IAudioSessionControl controlla una sessione audio. Una sessione audio è una raccolta di flussi in modalità condivisa. Questa interfaccia non funziona con flussi in modalità esclusiva.

Per un esempio di codice che usa l'interfaccia IAudioSessionControl , vedi Eventi audio per applicazioni audio legacy.

Ereditarietà

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

Metodi

L'interfaccia IAudioSessionControl include questi metodi.

IAudioSessionControl::GetDisplayName Il metodo GetDisplayName recupera il nome visualizzato per la sessione audio.
IAudioSessionControl::GetGroupingParam Il metodo GetGroupingParam recupera il parametro di raggruppamento della sessione audio.
IAudioSessionControl::GetIconPath Il metodo GetIconPath recupera il percorso dell'icona di visualizzazione per la sessione audio.
IAudioSessionControl::GetState Il metodo GetState recupera lo stato corrente della sessione audio.
IAudioSessionControl::RegisterAudioSessionNotification Il metodo RegisterAudioSessionNotification registra il client per ricevere notifiche di eventi di sessione, incluse le modifiche nello stato del flusso.
IAudioSessionControl::SetDisplayName Il metodo SetDisplayName assegna un nome visualizzato alla sessione corrente.
IAudioSessionControl::SetGroupingParam Il metodo SetGroupingParam assegna una sessione a un raggruppamento di sessioni.
IAudioSessionControl::SetIconPath Il metodo SetIconPath assegna un'icona di visualizzazione alla sessione corrente.
IAudioSessionControl::UnregisterAudioSessionNotification Il metodo UnregisterAudioSessionNotification elimina una registrazione precedente dal client per ricevere notifiche.

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	audiopolicy.h

Vedi anche

Interfacce audio di base

IAudioClient::GetService

IAudioClient::Initialize

IAudioSessionManager::GetAudioSessionControl

WASAPI