Condividi tramite


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