Metodo IXAudio2::Release (xaudio2.h)
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 |