Interface IAudioSessionManager (audiopolicy.h)

A interface IAudioSessionManager permite que um cliente acesse os controles de sessão e os controles de volume para sessões de áudio específicas do processo e do processo. O cliente obtém uma referência a uma interface IAudioSessionManager chamando o método IMMDevice::Activate com o parâmetro iid definido como REFIID IID_IAudioSessionManager.

Essa interface permite que os clientes acessem os controles de uma sessão existente sem primeiro abrir um fluxo. Essa funcionalidade é útil para clientes de APIs de nível superior que são criadas sobre WASAPI e usam controles de sessão internamente, mas não dão aos clientes acesso aos controles de sessão.

No Windows Vista, as APIs de nível superior que usam WASAPI incluem Media Foundation, DirectSound, as funções waveInXxx, waveOutXxx e mciXxx do Windows e APIs de terceiros.

Quando um cliente cria um fluxo de áudio por meio de uma API de nível superior, essa API normalmente adiciona o fluxo à sessão de áudio padrão para o processo do cliente (a sessão identificada pelo valor guid da sessão, GUID_NULL), mas a mesma API pode não fornecer um meio para o cliente acessar os controles dessa sessão. Nesse caso, o cliente pode acessar os controles por meio da interface IAudioSessionManager .

Para obter um exemplo de código que usa a interface IAudioSessionManager , consulte Eventos de áudio para aplicativos de áudio herdados.

Herança

A interface IAudioSessionManager herda da interface IUnknown . IAudioSessionManager também tem estes tipos de membros:

Métodos

A interface IAudioSessionManager tem esses métodos.

IAudioSessionManager::GetAudioSessionControl O método GetAudioSessionControl recupera um controle de sessão de áudio.
IAudioSessionManager::GetSimpleAudioVolume O método GetSimpleAudioVolume recupera um controle de volume de áudio simples.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	audiopolicy.h

Confira também

Principais interfaces de áudio

IMMDevice::Activate

WASAPI