Interfaccia IAudioSessionEvents (audiopolicy.h)
L'interfaccia IAudioSessionEvents fornisce notifiche di eventi correlati alla sessione, ad esempio modifiche nel livello del volume, nome visualizzato e stato sessione. A differenza delle altre interfacce di questa sezione, implementate dal componente di sistema WASAPI, un client WASAPI implementa l'interfaccia IAudioSessionEvents . Per ricevere notifiche evento, il client passa un puntatore alla relativa interfaccia IAudioSessionEvents al metodo IAudioSessionControl::RegisterAudioSessionNotification .
Dopo aver registrato la relativa interfaccia IAudioClientSessionEvents , il client riceve notifiche di evento sotto forma di callback tramite i metodi nell'interfaccia.
Nell'implementazione dell'interfaccia IAudioSessionEvents , il client deve osservare queste regole per evitare deadlock e comportamento non definito:
- I metodi nell'interfaccia devono essere non sbloccati. Il client non deve mai attendere su un oggetto di sincronizzazione durante un callback di eventi.
- Il client non deve mai chiamare il metodo IAudioSessionControl::UnregisterAudioSessionNotification durante un callback dell'evento.
- Il client non deve mai rilasciare il riferimento finale in un oggetto WASAPI durante un callback di eventi.
Ereditarietà
L'interfaccia IAudioSessionEvents eredita dall'interfaccia IUnknown . IAudioSessionEvents include anche questi tipi di membri:
Metodi
L'interfaccia IAudioSessionEvents include questi metodi.
| IAudioSessionEvents::OnChannelVolumeChanged Il metodo OnChannelVolumeChanged notifica al client che il livello di volume di un canale audio nella sottomix sessione è cambiato. |
| IAudioSessionEvents::OnDisplayNameChanged Il metodo OnDisplayNameChanged notifica al client che il nome visualizzato per la sessione è stato modificato. |
| IAudioSessionEvents::OnGroupingParamChanged Il metodo OnGroupingParamChanged notifica al client che il parametro di raggruppamento per la sessione è stato modificato. |
| IAudioSessionEvents::OnIconPathChanged Il metodo OnIconPathChanged notifica al client che l'icona di visualizzazione per la sessione è stata modificata. |
| IAudioSessionEvents::OnSessionDisconnected Il metodo OnSessionDisconnected notifica al client che la sessione audio è stata disconnessa. |
| IAudioSessionEvents::OnSimpleVolumeChanged Il metodo OnSimpleVolumeChanged notifica al client che il livello del volume o la modifica dello stato di modifica della sessione audio. |
| IAudioSessionEvents::OnStateChanged Il metodo OnStateChanged notifica al client che lo stato dell'attività di flusso della sessione è cambiato. |
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
IAudioSessionControl::RegisterAudioSessionNotification