Fungsi KeReadStateSemaphore (wdm.h)

Rutinitas KeReadStateSemaphore mengembalikan status saat ini, sinyal atau tidak diberi sinyal, dari objek semaphore yang ditentukan.

Sintaks

LONG KeReadStateSemaphore(
  [in] PRKSEMAPHORE Semaphore
);

Parameter

[in] Semaphore

Penunjuk ke objek semaphore yang diinisialisasi yang disediakan pemanggil penyimpanan.

Nilai kembali

Jika nilai yang dikembalikan adalah nol, objek semaphore diatur ke status tidak diberi sinyal.

Keterangan

Rutinitas ini memberikan cara yang efisien untuk melakukan polling status sinyal semaphore. KeReadStateSemaphore membaca status semaphore tanpa menyinkronkan aksesnya ke semaphore. Jangan berasumsi bahwa akses status semaphore oleh KeReadStateSemaphore saling eksklusif dari akses oleh rutinitas, seperti KeReleaseSemaphore dan KeWaitForSingleObject, yang menyinkronkan akses mereka ke status semaphore.

Untuk informasi selengkapnya tentang objek semaphore, lihat Objek Semaphore.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia dimulai dengan Windows 2000.
Target Platform	Universal
Header	wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	Tingkat apa pun
Aturan kepatuhan DDI	HwStorPortProhibitedDDIs(storport)

Lihat juga

KeInitializeSemaphore

KeReleaseSemaphore

KeWaitForsingleObject