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 |