Enumeração AudioSessionState (audiosessiontypes.h)

Artigo
02/23/2024

A enumeração AudioSessionState define constantes que indicam o estado atual de uma sessão de áudio.

Syntax

typedef enum _AudioSessionState {
  AudioSessionStateInactive,
  AudioSessionStateActive,
  AudioSessionStateExpired
} AudioSessionState;

Constantes


`AudioSessionStateInactive` A sessão de áudio está inativa. (Ele contém pelo menos um fluxo, mas nenhum dos fluxos na sessão está em execução no momento.)
`AudioSessionStateActive` A sessão de áudio está ativa. (Pelo menos um dos fluxos na sessão está em execução.)
`AudioSessionStateExpired` A sessão de áudio expirou. (Ele não contém fluxos.)

Comentários

Quando um cliente abre uma sessão atribuindo o primeiro fluxo à sessão (chamando o método IAudioClient::Initialize ), o estado inicial da sessão fica inativo. O estado da sessão muda de inativo para ativo quando um fluxo na sessão começa a ser executado (porque o cliente chamou o método IAudioClient::Start ). A sessão muda de ativa para inativa quando o cliente interrompe o último fluxo em execução na sessão (chamando o método IAudioClient::Stop ). O estado da sessão muda para expirado quando o cliente destrói o último fluxo na sessão liberando todas as referências ao objeto de fluxo.

O programa de controle de volume do sistema, Sndvol, exibe controles de volume para sessões ativas e inativas. O Sndvol para de exibir o controle de volume de uma sessão quando o estado da sessão é alterado para expirado. Para obter mais informações sobre o Sndvol, consulte Sessões de áudio.

Os métodos IAudioSessionControl::GetState e IAudioSessionEvents::OnStateChanged usam as constantes definidas na enumeração AudioSessionState .

Para obter mais informações sobre estados de sessão, consulte Sessões de áudio.

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]
Cabeçalho	audiosessiontypes.h