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

Weitere Informationen

IXAudio2