Metodo IXAudio2SourceVoice::SetFrequencyRatio (xaudio2.h)

Articolo
08/28/2023

Imposta il rapporto di regolazione della frequenza della voce.

Sintassi

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

Parametri

[in] Ratio

Rapporto di regolazione della frequenza. Questo valore deve essere compreso tra XAUDIO2_MIN_FREQ_RATIO e il parametro MaxFrequencyRatio specificato al momento della creazione della voce (vedere IXAudio2::CreateSourceVoice). XAUDIO2_MIN_FREQ_RATIO attualmente è pari a 0,0005, che consente di abbassare il passo fino a 11 ottave.

[in] OperationSet

Identifica questa chiamata come parte di un batch posticipato. Per altre informazioni, vedere panoramica dei set di operazioni XAudio2 .

Valore restituito

Restituisce S_OK in caso di esito positivo, in caso contrario, un codice di errore. Per le descrizioni dei codici di errore, vedere Codici di errore XAudio2 .

Commenti

La regolazione della frequenza è espressa comefrequenza di destinazione della frequenza di origine / . La modifica del rapporto di frequenza modifica la riproduzione dell'audio della frequenza nella voce. Un rapporto maggiore di 1,0 causerà la riproduzione dell'audio più veloce e un rapporto inferiore a 1,0 causerà un rallentamento della riproduzione dell'audio. Inoltre, il rapporto di frequenza influisce sull'inclinazione dell'audio sulla voce. Ad esempio, un valore pari a 1,0 non ha alcun effetto sull'audio, mentre un valore pari a 2,0 aumenta l'inclinazione di un'ottava e 0,5 lo riduce di un'ottava.

Se SetFrequencyRatio viene chiamato specificando un valore ratio esterno all'intervallo valido, il metodo imposterà il rapporto di frequenza al valore valido più vicino. Verrà generato anche un avviso per le compilazioni di debug.

NotaIXAudio2SourceVoice::GetFrequencyRatio restituisce sempre il rapporto di frequenza corrente effettivo della voce. Tuttavia, questo potrebbe non corrispondere al rapporto impostato dalla chiamata IXAudio2SourceVoice::SetFrequencyRatio : il rapporto effettivo viene modificato solo alla successiva esecuzione del motore audio dopo la chiamata IXAudio2SourceVoice::SetFrequencyRatio (o dopo la chiamata IXAudio2::CommitChanges corrispondente, se IXAudio2SourceVoice::SetFrequencyRatio è stato chiamato con un ID operazione posticipato).

Requisiti della piattaforma

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

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	xaudio2.h

Vedi anche

Procedura: Modificare l'inclinazione vocale

IXAudio2SourceVoice

Condividi tramite