Método IXAudio2::Release (xaudio2.h)
Libera uma referência ao objeto XAudio2.
Sintaxe
ULONG Release();
Valor retornado
Sempre retorna 0.
Comentários
Quando a versão final é chamada em um determinado objeto XAudio2, todos os objetos de voz associados a ele são destruídos. Todos os ponteiros para esses objetos que ainda são mantidos pelo cliente tornam-se inválidos imediatamente. Todas as chamadas feitas a elas causam um comportamento indefinido. O mecanismo de processamento de áudio também é interrompido. Isso ocorre para que, depois que Release for retornado, o cliente possa liberar com segurança todos os dados referenciados pelo grafo (por exemplo, buffers de origem de áudio ou objetos de tratamento de retorno de chamada).
A versão é uma chamada síncrona. Embora a falha não ocorra (uma vez que ele usa apenas brevemente o bloqueio de processamento), um título pode evitar tempos de espera de thread potenciais chamando esse método em um retorno de chamada XAudio2.
É inválido chamar Release 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
Plataforma de Destino | Windows |
Cabeçalho | xaudio2.h |