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

Destrói a voz. Se necessário, interrompe a voz e a remove do grafo XAudio2.

Sintaxe

\\ void DestroyVoice();

Retornar valor

Esse método não retorna um valor.

Comentários

Se qualquer outra voz estiver enviando áudio para essa voz no momento, o método falhará.

O DestroyVoice aguarda que o thread de processamento de áudio fique ocioso, portanto, pode demorar um pouco (normalmente não mais do que alguns milissegundos). Isso é necessário para garantir que a voz não faça mais nenhum retorno de chamada ou leia dados de áudio, de modo que o aplicativo possa liberar esses recursos com segurança assim que a chamada retornar.

Para evitar interrupções de thread de título de uma chamada DestroyVoice de bloqueio, o aplicativo pode destruir vozes em um thread não crítico separado ou o aplicativo pode usar estratégias de pool de voz para reutilizar vozes em vez de destruí-las. Observe que as vozes só podem ser reutilizados com áudio que tenha o mesmo formato de dados e o mesmo número de canais com os quais a voz foi criada. Uma voz pode reproduzir dados de áudio com taxas de exemplo diferentes das da voz chamando IXAudio2SourceVoice::SetFrequencyRatio com um parâmetro de taxa apropriado.

É inválido chamar DestroyVoice de dentro de um retorno de chamada (ou seja, IXAudio2EngineCallback ou IXAudio2VoiceCallback).

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

IXAudio2Voice