Metode IDebugControl3::WaitForEvent (dbgeng.h)
Metode WaitForEvent menunggu peristiwa yang masuk ke aplikasi mesin debugger.
Sintaks
HRESULT WaitForEvent(
[in] ULONG Flags,
[in] ULONG Timeout
);
Parameter
[in] Flags
Atur ke nol. Saat ini tidak ada bendera yang dapat digunakan dalam parameter ini.
[in] Timeout
Menentukan berapa milidetik yang harus ditunggu sebelum metode ini akan kembali. Jika Timeout INFINITE, metode ini tidak akan kembali sampai peristiwa yang masuk ke aplikasi mesin debugger terjadi atau gangguan keluar dikeluarkan. Jika sesi saat ini memiliki target kernel langsung, Timeout harus diatur ke INFINITE.
Nilai kembali
Metode ini dapat mengembalikan nilai kesalahan lainnya dan nilai kesalahan di atas mungkin memiliki arti tambahan. Lihat Mengembalikan Nilai untuk detail selengkapnya.
Menampilkan kode | Deskripsi |
---|---|
|
Metode berhasil. |
|
Waktu habis kedaluwarsa. |
|
Gangguan keluar dikeluarkan. Target tidak tersedia. |
|
Apakah ada permintaan input yang luar biasa, atau tidak ada target yang dapat menghasilkan peristiwa. |
|
Mesin sudah menunggu peristiwa. |
Keterangan
Metode ini hanya dapat dipanggil dari utas yang memulai sesi debugger.
Ketika peristiwa terjadi, mesin debugger akan memproses peristiwa dan memanggil panggilan balik peristiwa. Jika salah satu panggilan balik ini menunjukkan bahwa peristiwa harus masuk ke aplikasi mesin debugger (dengan mengembalikan DEBUG_STATUS_BREAK), metode ini akan kembali; jika tidak, itu akan terus menunggu peristiwa. Filter peristiwa juga dapat menentukan bahwa peristiwa harus dipecah ke dalam aplikasi mesin debugger. Untuk informasi selengkapnya tentang filter peristiwa, lihat Mengontrol Pengecualian dan Peristiwa.
Metode ini tidak entrant ulang. Setelah dipanggil, itu tidak dapat dipanggil lagi pada klien mana pun sampai kembali. Secara khusus, ini tidak dapat dipanggil dari panggilan balik peristiwa, termasuk ekstensi dan perintah yang dijalankan oleh panggilan balik.
Jika tidak ada target yang mampu menghasilkan peristiwa -- misalnya, semua target telah keluar -- metode ini akan mengakhiri sesi saat ini, membuang target, lalu mengembalikan E_UNEXPECTED.
Konstanta INFINITE didefinisikan dalam Winbase.h.
Untuk informasi selengkapnya tentang menggunakan WaitForEvent untuk mengontrol alur eksekusi aplikasi debugger dan target, lihat Sesi Debugging dan Model Eksekusi. Untuk detail tentang panggilan balik peristiwa, lihat Memantau Peristiwa.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Desktop |
Header | dbgeng.h (termasuk Dbgeng.h, Winbase.h) |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk