Método IAudioSessionManager::GetAudioSessionControl (audiopolicy.h)

O método GetAudioSessionControl recupera um controle de sessão de áudio.

Sintaxe

HRESULT GetAudioSessionControl(
  [in]  LPCGUID              AudioSessionGuid,
  [in]  DWORD                StreamFlags,
  [out] IAudioSessionControl **SessionControl
);

Parâmetros

[in] AudioSessionGuid

Ponteiro para um GUID de sessão. Se o GUID não identificar uma sessão que foi aberta anteriormente, a chamada abrirá uma sessão nova, mas vazia. O programa Sndvol não exibe um controle de nível de volume para uma sessão, a menos que contenha um ou mais fluxos ativos. Se esse parâmetro for NULL ou apontar para o valor GUID_NULL, o método atribuirá o fluxo à sessão padrão.

[in] StreamFlags

Especifica o status dos sinalizadores para o fluxo de áudio.

[out] SessionControl

Ponteiro para uma variável de ponteiro na qual o método grava um ponteiro na interface IAudioSessionControl do objeto de controle de sessão de áudio. O chamador é responsável por liberar a interface, quando ela não é mais necessária, chamando o método Release da interface. Se a chamada falhar, *SessionControl será NULL.

Valor retornado

Se o método for bem-sucedido, retornará S_OK. Se falhar, os códigos de retorno possíveis incluem, mas não se limitam a, os valores mostrados na tabela a seguir.

Código de retorno Descrição
AUDCLNT_E_NOT_INITIALIZED
O fluxo de áudio não foi inicializado com êxito.
AUDCLNT_E_DEVICE_INVALIDATED
O dispositivo de ponto de extremidade de áudio foi desconectado ou o hardware de áudio ou os recursos de hardware associados foram reconfigurados, desabilitados, removidos ou indisponíveis para uso.
AUDCLNT_E_SERVICE_NOT_RUNNING
O serviço de áudio do Windows não está em execução.
E_POINTER
O parâmetro SessionControl é NULL.
E_MEMORY
Sem memória.

Comentários

Para obter um exemplo de código que chama esse método, consulte Eventos de áudio para aplicativos de áudio herdados.

Requisitos

   
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

IAudioSessionControl Interface

IAudioSessionManager Interface