Método IXAudio2SourceVoice::SetSourceSampleRate (xaudio2.h)
Vuelve a configurar la voz para consumir datos de origen con una frecuencia de muestreo diferente a la especificada cuando se creó la voz.
Sintaxis
HRESULT SetSourceSampleRate(
[in] UINT32 NewSourceSampleRate
);
Parámetros
[in] NewSourceSampleRate
La nueva frecuencia de muestreo a la que la voz debe procesar los datos enviados. Las velocidades de muestreo válidas son de 1kHz a 200 kHz.
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 método SetSourceSampleRate admite la reutilización de voces XAudio2 al permitir que una voz reproduzca sonidos con una variedad de frecuencias de muestreo. Para usar SetSourceSampleRate , la voz debe haberse creado sin las marcas XAUDIO2_VOICE_NOPITCH o XAUDIO2_VOICE_NOSRC y no debe tener ningún búfer en cola actualmente.
El uso típico de SetSourceSampleRate es admitir la agrupación de voz. Por ejemplo, para admitir la agrupación de voz, una aplicación crearía previamente todas las voces que espera usar. Cada vez que se reproduce un nuevo sonido, la aplicación elige una voz inactiva o , si todas las voces están ocupadas, elige la voz menos importante y llama a SetSourceSampleRate en la voz con la frecuencia de muestreo del nuevo sonido. Después de llamar a SetSourceSampleRate en la voz, la aplicación puede empezar inmediatamente a enviar y reproducir búferes con la nueva frecuencia de muestreo. Esto permite a la aplicación evitar la sobrecarga de crear y destruir voces con frecuencia durante el juego.
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 |