Fungsi KeReadStateMutex (wdm.h)

  • Artikel

Rutinitas KeReadStateMutex mengembalikan status saat ini, disinyalkan atau tidak diberi sinyal, dari objek mutex yang ditentukan.

Sintaks

LONG KeReadStateMutex(
  [in] PRKMUTEX Mutex
);

Parameter

[in] Mutex

Penunjuk ke objek mutex yang diinisialisasi yang disediakan pemanggil penyimpanan.

Nilai kembali

Jika nilai yang dikembalikan adalah 1, status objek mutex akan disinyalkan.

Keterangan

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

Untuk informasi selengkapnya tentang objek mutex, lihat Objek Mutex.

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 <= DISPATCH_LEVEL
Aturan kepatuhan DDI HwStorPortProhibitedDDIs(storport)

Lihat juga

ExInitializeFastMutex

KeInitializeMutex

KeReleaseMutex

KeWaitForsingleObject