IXAudio2::Release-Methode (xaudio2.h)
Gibt einen Verweis auf das XAudio2-Objekt frei.
Syntax
ULONG Release();
Rückgabewert
Es wird immer 0 zurückgegeben.
Hinweise
Wenn das endgültige Release für ein bestimmtes XAudio2-Objekt aufgerufen wird, werden alle ihm zugeordneten Sprachobjekte zerstört. Alle Zeiger auf diese Objekte, die sich noch im Client befinden, werden sofort ungültig. Alle Aufrufe, die an sie vorgenommen werden, führen zu undefiniertem Verhalten. Die Audioverarbeitungs-Engine wird ebenfalls beendet. Dies ist so, dass der Client nach der Rückgabe von Release alle Daten, auf die vom Diagramm verwiesen wird, sicher freigeben kann (z. B. Audioquellenpuffer oder Rückrufbehandlungsobjekte).
Release ist ein synchroner Aufruf. Während keine Störungen auftreten sollten (da die Verarbeitungssperre nur kurz verwendet wird), kann ein Titel potenzielle Threadwartezeiten vermeiden, indem diese Methode in einem XAudio2-Rückruf aufgerufen wird.
Es ist ungültig, Release innerhalb eines Rückrufs (d. a. IXAudio2EngineCallback oder IXAudio2VoiceCallback) aufzurufen.
Plattformanforderungen
Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); DirectX SDK (XAudio 2.7)Requirements (Anforderungen)
| Zielplattform | Windows |
| Kopfzeile | xaudio2.h |