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

  • Artículo

Establece la relación de ajuste de frecuencia de la voz.

Sintaxis

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

Parámetros

[in] Ratio

Relación de ajuste de frecuencia. Este valor debe estar entre XAUDIO2_MIN_FREQ_RATIO y el parámetro MaxFrequencyRatio especificado cuando se creó la voz (vea IXAudio2::CreateSourceVoice). XAUDIO2_MIN_FREQ_RATIO actualmente es 0,0005, lo que permite reducir el tono en hasta 11 octavas.

[in] OperationSet

Identifica esta llamada como parte de un lote diferido. Consulte la información general sobre conjuntos de operaciones XAudio2 para obtener más información.

Valor devuelto

Devuelve S_OK si se ejecuta correctamente, de lo contrario, un código de error. Consulte Códigos de error de XAudio2 para obtener descripciones de los códigos de error.

Comentarios

El ajuste de frecuencia se expresa como frecuencia de destino de frecuencia de origen / . Cambiar la relación de frecuencia cambia la frecuencia de audio se reproduce en la voz. Una relación mayor que 1,0 hará que el audio se reproduzca más rápido y una relación menor que 1,0 hará que el audio se reproduzca más lentamente. Además, la relación de frecuencia afecta al tono de audio en la voz. Por ejemplo, un valor de 1,0 no tiene ningún efecto en el audio, mientras que un valor de 2,0 eleva el tono en una octava y 0,5 lo reduce en una octava.

Si se llama a SetFrequencyRatio especificando un valor ratio fuera del intervalo válido, el método establecerá la relación de frecuencia en el valor válido más cercano. También se generará una advertencia para las compilaciones de depuración.

NotaIXAudio2SourceVoice::GetFrequencyRatio siempre devuelve la relación de frecuencia actual real de la voz. Sin embargo, es posible que esto no coincida con la relación establecida por la llamada IXAudio2SourceVoice::SetFrequencyRatio : la relación real solo se cambia la próxima vez que se ejecute el motor de audio después de la llamada IXAudio2SourceVoice::SetFrequencyRatio (o después de la llamada IXAudio2::CommitChanges , si IXAudio2SourceVoice::SetFrequencyRatio se llamó con un identificador de operación diferido).
 

Requisitos de la plataforma

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

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado xaudio2.h

Consulte también

Cómo: Cambiar el tono de voz

IXAudio2SourceVoice