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

O método GetSimpleAudioVolume recupera um controle de volume de áudio simples.

Sintaxe

HRESULT GetSimpleAudioVolume(
  [in]  LPCGUID            AudioSessionGuid,
  [in]  DWORD              StreamFlags,
  [out] ISimpleAudioVolume **AudioVolume
);

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 se a solicitação é para uma sessão entre processos. Defina como TRUE se a sessão for entre processos. Defina como FALSE se a sessão não estiver entre processos.

[out] AudioVolume

Ponteiro para uma variável de ponteiro na qual o método grava um ponteiro para a interface ISimpleAudioVolume do objeto de controle de volume de áudio. Essa interface representa o controle de volume de áudio simples para o processo atual. 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 Ativar falhar, *AudioVolume será NULL.

Retornar valor

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.

Requisitos

Confira também

IAudioSessionManager Interface

ISimpleAudioVolume Interface