Fungsi StorPortQueryDpcWatchdogInformation (storport.h)

Artikel
08/07/2023

StorPortQueryDpcWatchdogInformation meminta nilai timer pengawas DPC untuk prosesor saat ini.

Sintaks

ULONG StorPortQueryDpcWatchdogInformation(
  [in]  PVOID                          HwDeviceExtension,
  [out] PSTOR_DPC_WATCHDOG_INFORMATION DpcWatchdogInformation
);

Parameter

[in] HwDeviceExtension

Penunjuk ke ekstensi perangkat miniport.

[out] DpcWatchdogInformation

Arahkan ke struktur STOR_DPC_WATCHDOG_INFORMATION tempat informasi pengawas DPC akan ditulis.

Nilai kembali

Fungsi ini mengembalikan salah satu kode status berikut.

Menampilkan kode	Deskripsi
STOR_STATUS_SUCCESS	Informasi pengawas DPC berhasil dikueri.
STOR_STATUS_INVALID_PARAMETER	Parameter tidak valid; misalnya, DpcWatchdogInformation adalah NULL.
STOR_STATUS_UNSUCCESSFUL	Dikembalikan karena alasan sistem internal lainnya.

Keterangan

Miniport dapat memanggil StorPortQueryDpcWatchdogInformation di IRQL=DISPATCH_LEVEL untuk menentukan jumlah waktu yang tersisa sebelum waktu habis panggilan prosedur yang ditangguhkan (DPC) terjadi. Sistem operasi mengimplementasikan timer pengawas DPC untuk mendeteksi kapan satu rutinitas DPC berjalan terlalu lama, atau ketika serangkaian rutinitas DPC yang diantrekan berjalan secara back-to-back terlalu lama. Jika kesalahan batas waktu 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.

StorPortQueryDpcWatchdogInformation harus dipanggil saat DPC berjalan atau dipanggil di IRQL= DISPATCH_LEVEL atau lebih tinggi pada prosesor saat ini. Jika tidak, panggilan gagal dan mengembalikan STOR_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 umum, lihat Panduan Untuk Menulis Rutinitas DPC.

Persyaratan

Persyaratan	Nilai
Server minimum yang didukung	Windows Server 2022
Header	storport.h
IRQL	DISPATCH_LEVEL

Lihat juga

STOR_DPC_WATCHDOG_INFORMATION

Bagikan melalui