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 |