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

Artigo
02/26/2024

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.

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 não estão disponí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 AudioVolume é NULL.
E_MEMORY	Sem memória.

Requisitos

Requisito	Valor
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

IAudioSessionManager Interface

ISimpleAudioVolume Interface

Share via