Bagikan melalui


IXAudio2::Metode rilis (xaudio2.h)

Merilis referensi ke objek XAudio2.

Sintaks

ULONG Release();

Mengembalikan nilai

Selalu mengembalikan 0.

Keterangan

Ketika Rilis akhir dipanggil pada objek XAudio2 tertentu, semua objek suara yang terkait dengannya dihancurkan. Setiap penunjuk ke objek ini yang masih dipegang oleh klien menjadi tidak valid segera. Setiap panggilan yang dilakukan kepada mereka menyebabkan perilaku yang tidak terdefinisi. Mesin pemrosesan audio juga dihentikan. Ini agar setelah Rilis dikembalikan, klien dapat dengan aman membebaskan data apa pun yang direferensikan oleh grafik (misalnya, buffer sumber audio atau objek penanganan panggilan balik).

Rilis adalah panggilan sinkron. Meskipun kesalahan tidak boleh terjadi (karena hanya mengambil kunci pemrosesan secara singkat), judul dapat menghindari potensi waktu tunggu utas dengan memanggil metode ini dalam panggilan balik XAudio2.

Tidak valid untuk memanggil Rilis dari dalam panggilan balik (yaitu, IXAudio2EngineCallback atau IXAudio2VoiceCallback).

Persyaratan Platform

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

Persyaratan

   
Target Platform Windows
Header xaudio2.h

Lihat juga

IXAudio2