Share via

Metodo IXAudio2::Release (xaudio2.h)

  • Articolo

Rilascia un riferimento all'oggetto XAudio2.

Sintassi

ULONG Release();

Valore restituito

Restituisce sempre 0.

Commenti

Quando la versione finale viene chiamata su un determinato oggetto XAudio2, tutti gli oggetti voce associati vengono eliminati definitivamente. Tutti i puntatori a questi oggetti ancora mantenuti dal client diventano immediatamente non validi. Tutte le chiamate effettuate a tali chiamate causano un comportamento non definito. Viene arrestato anche il motore di elaborazione audio. In questo modo, dopo la restituzione di Release , il client può liberare in modo sicuro tutti i dati a cui fa riferimento il grafo , ad esempio buffer di origine audio o oggetti di gestione del callback.

Release è una chiamata sincrona. Anche se l'errore non deve verificarsi (poiché richiede solo brevemente il blocco di elaborazione), un titolo può evitare potenziali tempi di attesa del thread chiamando questo metodo in un callback XAudio2.

Non è possibile chiamare Release dall'interno di un callback, ovvero IXAudio2EngineCallback o IXAudio2VoiceCallback.

Requisiti della piattaforma

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); DirectX SDK (XAudio 2.7)

Requisiti

   
Piattaforma di destinazione Windows
Intestazione xaudio2.h

Vedi anche

IXAudio2