Interface IAudioSessionControl (audiopolicy.h)
A interface IAudioSessionControl permite que um cliente configure os parâmetros de controle para uma sessão de áudio e monitore eventos na sessão. O método IAudioClient::Initialize inicializa um objeto stream e atribui o fluxo a uma sessão de áudio. O cliente obtém uma referência à interface IAudioSessionControl em um objeto de fluxo chamando o método IAudioClient::GetService com riid de parâmetro definido como REFIID IID_IAudioSessionControl.
Como alternativa, um cliente pode obter a interface IAudioSessionControl de uma sessão existente sem precisar primeiro criar um objeto de fluxo e adicionar o fluxo à sessão. Em vez disso, o cliente chama o método IAudioSessionManager::GetAudioSessionControl com o parâmetro AudioSessionGuid definido como o GUID da sessão.
O cliente pode se registrar para receber notificação do gerenciador de sessão quando os clientes alterarem os parâmetros de sessão por meio dos métodos na interface IAudioSessionControl .
Ao liberar uma instância de interface IAudioSessionControl , o cliente deve chamar o método Release da interface do mesmo thread que a chamada para IAudioClient::GetService que criou o objeto.
A interface IAudioSessionControl controla uma sessão de áudio. Uma sessão de áudio é uma coleção de fluxos de modo compartilhado. Essa interface não funciona com fluxos de modo exclusivo.
Para obter um exemplo de código que usa a interface IAudioSessionControl , consulte Eventos de áudio para aplicativos de áudio herdados.
Herança
A interface IAudioSessionControl herda da interface IUnknown . IAudioSessionControl também tem estes tipos de membros:
Métodos
A interface IAudioSessionControl tem esses métodos.
| IAudioSessionControl::GetDisplayName O método GetDisplayName recupera o nome de exibição da sessão de áudio. |
| IAudioSessionControl::GetGroupingParam O método GetGroupingParam recupera o parâmetro de agrupamento da sessão de áudio. |
| IAudioSessionControl::GetIconPath O método GetIconPath recupera o caminho do ícone de exibição da sessão de áudio. |
| IAudioSessionControl::GetState O método GetState recupera o estado atual da sessão de áudio. |
| IAudioSessionControl::RegisterAudioSessionNotification O método RegisterAudioSessionNotification registra o cliente para receber notificações de eventos de sessão, incluindo alterações no estado do fluxo. |
| IAudioSessionControl::SetDisplayName O método SetDisplayName atribui um nome de exibição à sessão atual. |
| IAudioSessionControl::SetGroupingParam O método SetGroupingParam atribui uma sessão a um agrupamento de sessões. |
| IAudioSessionControl::SetIconPath O método SetIconPath atribui um ícone de exibição à sessão atual. |
| IAudioSessionControl::UnregisterAudioSessionNotification O método UnregisterAudioSessionNotification exclui um registro anterior do cliente para receber notificações. |
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | audiopolicy.h |
Confira também
Principais interfaces de áudio