Compartilhar via


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

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

Confira também

IAudioSessionManager2