IXAudio2Voice::D estroyVoice method (xaudio2.h)
Menghancurkan suara. Jika perlu, menghentikan suara dan menghapusnya dari grafik XAudio2.
Sintaks
\\ void DestroyVoice();
Mengembalikan nilai
Metode ini tidak mengembalikan nilai.
Keterangan
Jika ada suara lain yang saat ini mengirim audio ke suara ini, metode gagal.
DestroyVoice menunggu utas pemrosesan audio diam, sehingga dapat memakan waktu sedikit (biasanya tidak lebih dari beberapa milidetik). Ini diperlukan untuk menjamin bahwa suara tidak akan lagi melakukan panggilan balik atau membaca data audio apa pun, sehingga aplikasi dapat membebaskan sumber daya ini dengan aman segera setelah panggilan kembali.
Untuk menghindari gangguan rangkaian judul dari panggilan DestroyVoice yang memblokir, aplikasi dapat menghancurkan suara pada utas non-kritis terpisah, atau aplikasi dapat menggunakan strategi pengumpulan suara untuk menggunakan kembali suara daripada menghancurkannya. Perhatikan bahwa suara hanya dapat digunakan kembali dengan audio yang memiliki format data yang sama dan jumlah saluran yang sama dengan suara yang dibuat. Suara dapat memutar data audio dengan laju sampel yang berbeda dari suara dengan memanggil IXAudio2SourceVoice::SetFrequencyRatio dengan parameter rasio yang sesuai.
Tidak valid untuk memanggil DestroyVoice 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
| Persyaratan | Nilai |
|---|---|
| Target Platform | Windows |
| Header | xaudio2.h |