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

IAudioClient::GetService

IAudioClient::Initialize

IAudioSessionManager::GetAudioSessionControl

WASAPI