Compartilhar via

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

  • Artigo

Define o nível de volume geral para a voz.

Sintaxe

\\HRESULT SetVolume(
  [in] float  Volume,
  [in] UINT32 OperationSet
);

Parâmetros

[in] Volume

Nível de volume geral a ser usado. Consulte Comentários para obter mais informações sobre níveis de volume.

[in] OperationSet

Identifica essa chamada como parte de um lote adiado. Consulte a Visão geral dos Conjuntos de Operações XAudio2 para obter mais informações.

Retornar valor

Retorna S_OK se tiver êxito, caso contrário, um código de erro. Consulte Códigos de erro XAudio2 para obter descrições de códigos de erro.

Comentários

SetVolume controla o nível de volume de entrada master de uma voz. O nível de volume master é aplicado em momentos diferentes, dependendo do tipo de voz. Para vozes de submixagem e masterização, o nível de volume é aplicado logo antes da cadeia de filtros e efeitos interna da voz ser aplicada. Para vozes de origem, o nível de volume master é aplicado após a aplicação da cadeia de filtros e efeitos da voz.

Os níveis de volume são expressos como multiplicadores de amplitude de ponto flutuante entre -XAUDIO2_MAX_VOLUME_LEVEL e XAUDIO2_MAX_VOLUME_LEVEL (-2²⁴ a 2²⁴), com um ganho máximo de 144,5 dB. Um nível de volume de 1,0 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çãoIXAudio2Voice::GetVolume 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

Requisito Valor
Plataforma de Destino Windows
Cabeçalho xaudio2.h

Confira também

Como alterar o volume de voz

Como: Usar vozes de submixagem

IXAudio2Voice