Fungsi KeInitializeMutex (wdm.h)

  • Artikel

Rutinitas KeInitializeMutex menginisialisasi objek mutex, mengaturnya ke status tersinyal.

Sintaks

void KeInitializeMutex(
  [out] PRKMUTEX Mutex,
  [in]  ULONG    Level
);

Parameter

[out] Mutex

Penunjuk ke objek mutex, tempat pemanggil menyediakan penyimpanan. Penyimpanan harus selaras dengan 4 byte pada platform 32-bit, dan selaras 8-byte pada platform 64-bit.

[in] Level

Dicadangkan. Driver mengatur ini ke nol.

Mengembalikan nilai

Tidak ada

Keterangan

Untuk performa yang lebih baik, gunakan mutex cepat atau mutex yang dijaga. Untuk informasi selengkapnya, lihat Alternatif untuk Objek Mutex.

Objek mutex diinisialisasi dengan status awal sinyal.

Penyimpanan untuk objek mutex harus merupakan residen: dalam ekstensi perangkat objek perangkat yang dibuat driver, dalam ekstensi pengontrol objek pengontrol yang dibuat driver, atau di kumpulan yang tidak disebarkan yang dialokasikan oleh pemanggil.

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 Tingkat apa pun
Aturan kepatuhan DDI HwStorPortProhibitedDDIs(storport)

Lihat juga

ExInitializeFastMutex

KeReadStateMutex

KeReleaseMutex

KeWaitForMultipleObjects

KeWaitForsingleObject