Método IAudioSessionManager2::GetSessionEnumerator (audiopolicy.h)

O método GetSessionEnumerator obtém um ponteiro para o objeto enumerador de sessão de áudio.

Sintaxe

HRESULT GetSessionEnumerator(
  [out] IAudioSessionEnumerator **SessionEnum
);

Parâmetros

[out] SessionEnum

Recebe um ponteiro para a interface IAudioSessionEnumerator do objeto enumerador de sessão que o cliente pode usar para enumerar sessões de áudio no dispositivo de áudio. Por meio desse método, o chamador obtém uma referência contada à interface . O chamador é responsável por liberar a interface, quando ela não é mais necessária, chamando o método Release da interface.

Retornar valor

Se o método for bem-sucedido, retornará S_OK.

Comentários

O gerenciador de sessão mantém uma coleção de sessões de áudio que estão ativas no dispositivo de áudio consultando o mecanismo de áudio. GetSessionEnumerator cria um controle de sessão para cada sessão na coleção. Para obter uma referência à interface IAudioSessionControl da sessão na coleção enumerada, o aplicativo deve chamar IAudioSessionEnumerator::GetSession. Para obter um exemplo de código, consulte Interface IAudioSessionEnumerator.

O enumerador de sessão pode não estar ciente das novas sessões que são relatadas por meio de IAudioSessionNotification. Portanto, se um aplicativo depende exclusivamente do enumerador de sessão para obter todas as sessões de um ponto de extremidade de áudio, os resultados podem não ser precisos. Para contornar isso, o aplicativo deve manter manualmente uma lista. Para obter mais informações, consulte IAudioSessionEnumerator.

Requisitos

Confira também

IAudioSessionManager2