Fungsi KeReadStateEvent (wdm.h)

Artikel
02/29/2024

Rutinitas KeReadStateEvent mengembalikan status saat ini, disinyalkan atau tidak diberi sinyal, dari objek peristiwa.

Sintaks

LONG KeReadStateEvent(
  [in] PRKEVENT Event
);

Parameter

[in] Event

Penunjuk ke objek peristiwa yang diinisialisasi tempat pemanggil menyediakan penyimpanan.

Nilai kembali

Jika objek peristiwa saat ini diatur ke status sinyal, nilai bukan nol dikembalikan. Jika tidak, nol dikembalikan.

Keterangan

Rutinitas ini menyediakan cara yang efisien untuk melakukan polling status sinyal suatu peristiwa. KeReadStateEvent membaca status peristiwa tanpa menyinkronkan aksesnya ke peristiwa. Jangan berasumsi bahwa akses status peristiwa oleh KeReadStateEvent saling eksklusif dari akses oleh rutinitas, seperti KeSetEvent dan KeWaitForSingleObject, yang menyinkronkan akses mereka ke status peristiwa.

Dimungkinkan juga untuk membaca status peristiwa dari rutinitas layanan interupsi driver di DIRQL, jika kondisi berikut terpenuhi: objek peristiwa driver adalah residen (mungkin dalam ekstensi perangkatnya), dan fungsi lain yang mengakses peristiwa menyinkronkan aksesnya dengan ISR.

Untuk informasi selengkapnya tentang objek peristiwa, lihat Objek Peristiwa.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia dimulai dengan Windows 2000.
Target Platform	Universal
Header	wdm.h (termasuk Ntddk.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL
Aturan kepatuhan DDI	HwStorPortProhibitedDDIs(storport), IrqlKeDispatchLte(wdm)

Lihat juga

KeWaitForsingleObject