Método IXAudio2Voice::D estroyVoice (xaudio2.h)

  • Artículo

Destruye la voz. Si es necesario, detiene la voz y la quita del gráfico XAudio2.

Sintaxis

\\ void DestroyVoice();

Valor devuelto

Este método no devuelve ningún valor.

Comentarios

Si alguna otra voz está enviando audio actualmente a esta voz, se produce un error en el método.

DestroyVoice espera a que el subproceso de procesamiento de audio esté inactivo, por lo que puede tardar un poco (normalmente no más de un par de milisegundos). Esto es necesario para garantizar que la voz ya no realizará devoluciones de llamada ni leerá ningún dato de audio, por lo que la aplicación puede liberar estos recursos de forma segura tan pronto como se devuelva la llamada.

Para evitar interrupciones del subproceso de título de una llamada destroyVoice de bloqueo, la aplicación puede destruir voces en un subproceso no crítico independiente o la aplicación puede usar estrategias de agrupación de voz para reutilizar voces en lugar de destruirlas. Tenga en cuenta que las voces solo se pueden reutilizar con audio que tengan el mismo formato de datos y el mismo número de canales con los que se creó la voz. Una voz puede reproducir datos de audio con diferentes velocidades de muestreo que la de la voz llamando a IXAudio2SourceVoice::SetFrequencyRatio con un parámetro de relación adecuado.

No es válido llamar a DestroyVoice desde dentro de una devolución de llamada (es decir, IXAudio2EngineCallback o IXAudio2VoiceCallback).

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

IXAudio2Voice