Compartilhar via

Método IXAudio2SourceVoice::SetFrequencyRatio (xaudio2.h)

  • Artigo

Define a taxa de ajuste de frequência da voz.

Sintaxe

HRESULT SetFrequencyRatio(
  [in] float  Ratio,
  [in] UINT32 OperationSet
);

Parâmetros

[in] Ratio

Taxa de ajuste de frequência. Esse valor deve estar entre XAUDIO2_MIN_FREQ_RATIO e o parâmetro MaxFrequencyRatio especificado quando a voz foi criada (consulte IXAudio2::CreateSourceVoice). XAUDIO2_MIN_FREQ_RATIO atualmente é 0,0005, o que permite que o pitch seja reduzido em até 11 oitavas.

[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

O ajuste de frequência é expresso comofrequência de destinode frequência / de origem. Alterar a taxa de frequência altera a taxa de áudio reproduzida na voz. Uma taxa maior que 1,0 fará com que o áudio seja reproduzido mais rapidamente e uma taxa menor que 1,0 fará com que o áudio seja reproduzido mais lentamente. Além disso, a taxa de frequência afeta o tom do áudio na voz. Por exemplo, um valor de 1,0 não tem efeito no áudio, enquanto um valor de 2,0 aumenta o tom em uma oitava e 0,5 o reduz em uma oitava.

Se SetFrequencyRatio for chamado especificando um valor ratio fora do intervalo válido, o método definirá a taxa de frequência como o valor válido mais próximo. Um aviso também será gerado para builds de depuração.

ObservaçãoIXAudio2SourceVoice::GetFrequencyRatio sempre retorna a taxa de frequência atual real da voz. No entanto, isso pode não corresponder à taxa definida pela chamada IXAudio2SourceVoice::SetFrequencyRatio mais recente: a taxa real só será alterada na próxima vez que o mecanismo de áudio for executado após a chamada IXAudio2SourceVoice::SetFrequencyRatio (ou após a chamada IXAudio2::CommitChanges correspondente, se IXAudio2SourceVoice::SetFrequencyRatio foi chamado com uma ID de operação adiada).
 

Requisitos da 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 tom de voz

IXAudio2SourceVoice