Compartilhar via


Método IAudioSessionEvents::OnStateChanged (audiopolicy.h)

O método OnStateChanged notifica o cliente de que o estado de atividade de fluxo da sessão foi alterado.

Sintaxe

HRESULT OnStateChanged(
  [in] AudioSessionState NewState
);

Parâmetros

[in] NewState

O novo estado da sessão. O valor desse parâmetro é um dos seguintes valores de enumeração AudioSessionState :

AudioSessionStateActive

AudioSessionStateInactive

AudioSessionStateExpired

Retornar valor

Se o método for bem-sucedido, retornará S_OK. Se falhar, retornará um código de erro.

Comentários

Um cliente não pode gerar um evento de alteração de estado de sessão. O sistema é sempre a origem desse tipo de evento. Portanto, ao contrário de alguns outros métodos IAudioSessionEvents , esse método não fornece um parâmetro de contexto.

O sistema altera o estado de uma sessão de inativa para ativa no momento em que um cliente abre o primeiro fluxo na sessão. Um cliente abre um fluxo chamando o método IAudioClient::Initialize . O sistema altera o estado da sessão de ativo para inativo no momento em que um cliente fecha o último fluxo na sessão. O cliente que libera a última referência a um objeto IAudioClient fecha o fluxo associado ao objeto .

Para obter um exemplo de código que implementa os métodos na interface IAudioSessionEvents , consulte Eventos de Sessão 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]
Plataforma de Destino Windows
Cabeçalho audiopolicy.h

Confira também

IAudioClient Interface

IAudioClient::Initialize

IAudioSessionEvents Interface