Método ISimpleAudioVolume::GetMasterVolume (audioclient.h)

  • Artigo

O método GetMasterVolume recupera o nível de volume do cliente para a sessão de áudio.

Sintaxe

HRESULT GetMasterVolume(
  [out] float *pfLevel
);

Parâmetros

[out] pfLevel

Ponteiro para uma variável float na qual o método grava o nível de volume do cliente. O nível de volume é um valor no intervalo de 0,0 a 1,0.

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
E_POINTER
 O parâmetro pfLevel é NULL.
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.

Comentários

Esse método recupera o nível de volume do cliente para a sessão. Esse é o nível de volume que o cliente definiu em uma chamada anterior para o método ISimpleAudioVolume::SetMasterVolume .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho audioclient.h

Confira também

IAudioClient::Initialize

ISimpleAudioVolume Interface

ISimpleAudioVolume::SetMasterVolume