Share via

Método IXAudio2::Release (xaudio2.h)

  • Artigo

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

Confira também

IXAudio2