Compartilhar via


Método IXAudio2Voice::GetVolume (xaudio2.h)

Obtém o nível de volume geral atual da voz.

Sintaxe

\\ void GetVolume(
  [out] float *pVolume
);

Parâmetros

[out] pVolume

Retorna o nível de volume geral atual da voz. Consulte Comentários para obter mais informações sobre níveis de volume.

Valor retornado

Esse método não retorna um valor.

Comentários

Os níveis de volume são expressos como multiplicadores de amplitude de ponto flutuante entre -224 e 224, com um ganho máximo de 144,5 dB. Um nível de volume de 1 significa que não há atenuação ou ganho e 0 significa silêncio. Níveis negativos podem ser usados para inverter a fase do áudio. Consulte Volume XAudio2 e Controle de Tom para obter informações adicionais sobre o controle de volume.

ObservaçãoGetVolume sempre retorna o volume definido mais recentemente por IXAudio2Voice::SetVolume. No entanto, ele pode ainda não estar em vigor: só entrará em vigor na próxima vez que o mecanismo de áudio for executado após a chamada IXAudio2Voice::SetVolume (ou após a chamada IXAudio2::CommitChanges correspondente, se IXAudio2Voice::SetVolume tiver sido chamado com uma ID de operação adiada).
 

Requisitos de plataforma

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); SDK do DirectX (XAudio 2.7)

Requisitos

   
Plataforma de Destino Windows
Cabeçalho xaudio2.h

Confira também

IXAudio2Voice