Fungsi KeQueryDpcWatchdogInformation (wdm.h)
Rutinitas KeQueryDpcWatchdogInformation mengembalikan nilai timer pengawas panggilan prosedur yang ditangguhkan (DPC) untuk prosesor saat ini.
Sintaks
NTSTATUS KeQueryDpcWatchdogInformation(
[out] PKDPC_WATCHDOG_INFORMATION WatchdogInformation
);
Parameter
[out] WatchdogInformation
Penunjuk ke struktur KDPC_WATCHDOG_INFORMATION yang disediakan penelepon. Rutinitas menulis nilai timer pengawas DPC saat ini ke struktur ini.
Nilai kembali
KeQueryDpcWatchdogInformation mengembalikan nilai NTSTATUS. Nilai yang mungkin dikembalikan termasuk kode status berikut.
Menampilkan kode | Deskripsi |
---|---|
|
KeQueryDpcWatchdogInformation dipanggil saat DPC berjalan pada prosesor saat ini. |
|
Prosesor saat ini tidak menjalankan DPC ketika KeQueryDpcWatchdogInformation dipanggil. |
Keterangan
Rutinitas KeQueryDpcWatchdogInformation dapat dipanggil dari rutinitas DPC atau pada IRQL= DISPATCH_LEVEL untuk menentukan jumlah waktu yang tersisa sebelum waktu habis DPC terjadi. Sistem operasi mengimplementasikan timer pengawas DPC untuk mendeteksi kapan satu rutinitas DPC berjalan terlalu lama, atau ketika serangkaian rutinitas DPC antrean berjalan back-to-back terlalu lama. Jika kesalahan waktu habis DPC diaktifkan, dan jika rutinitas DPC melebihi batas waktu untuk satu rutinitas, atau serangkaian rutinitas DPC melebihi batas waktu agregat, pemeriksaan bug DPC_WATCHDOG_VIOLATION (0x133) terjadi.
KeQueryDpcWatchdogInformation harus dipanggil saat DPC berjalan atau dipanggil pada IRQL= DISPATCH_LEVEL atau lebih tinggi pada prosesor saat ini. Jika tidak, panggilan gagal dan mengembalikan STATUS_UNSUCCESSFUL.
Rutinitas DPC harus berjalan hanya untuk jangka waktu singkat, dan harus mendelegasikan pemrosesan sebanyak mungkin untuk utas pekerja. Untuk menghindari penurunan respons sistem, rutinitas DPC yang khas harus berjalan tidak lebih dari 100 mikrodetik setiap kali dipanggil. Untuk informasi selengkapnya, lihat Panduan Menulis Rutinitas DPC.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Tersedia dimulai dengan Windows Vista. |
Target Platform | Universal |
Header | wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h) |
Pustaka | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | DISPATCH_LEVEL |