Metode IXAudio2EngineCallback::OnCriticalError (xaudio2.h)

Dipanggil jika terjadi kesalahan sistem penting yang mengharuskan XAudio2 ditutup dan dimulai ulang.

Sintaks

void OnCriticalError(
  HRESULT Error
);

Parameter

Error

Kode kesalahan yang dikembalikan oleh XAudio2.

Menampilkan nilai

Tidak ada

Keterangan

Jika Anda memberikan ID perangkat tertentu dalam parameter szDeviceId ke IXAudio2::CreateMasteringVoice atau menggunakan bendera XAUDIO2_NO_VIRTUAL_AUDIO_CLIENT, maka kesalahan kritis akan terjadi dan OnCriticalError dimunculkan jika perangkat penyajian WASAPI yang mendasar menjadi tidak tersedia. Ini dapat terjadi ketika headset atau speaker dilepas atau saat perangkat audio USB dihapus, misalnya. Setelah terjadi kesalahan kritis, pemrosesan audio berhenti dan semua panggilan lebih lanjut ke XAudio2 gagal. Satu-satunya cara untuk pulih dalam situasi ini adalah dengan merilis instans XAudio2 dan membuat yang baru.

Jika Anda menentukan parameter NULL atau szDeviceId ke IXAudio2::CreateMasteringVoice, maka sistem menggunakan Klien Audio Virtual untuk mewakili titik akhir audio. Dalam hal ini, jika perangkat penyajian WASAPI yang mendasar menjadi tidak tersedia, sistem secara otomatis memilih perangkat penyajian audio baru untuk penyajian, pemrosesan audio berlanjut, dan OnCriticalError tidak dinaikkan.

Pada keluarga perangkat seluler, Klien Audio Virtual selalu digunakan dan OnCriticalError tidak pernah dinaikkan, terlepas dari nilai yang Anda berikan ke CreateMasteringVoice.

Untuk informasi tentang metode antarmuka IXAudio2EngineCallback , lihat bagian Panggilan Balik XAudio2 .

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

IXAudio2EngineCallback

Panggilan Balik XAudio2