Freigeben über


KeInitializeMutex-Funktion (wdm.h)

Die KeInitializeMutex-Routine initialisiert ein Mutex-Objekt und setzt es auf einen signalisierten Zustand.

Syntax

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

Parameter

[out] Mutex

Zeiger auf ein Mutex-Objekt, für das der Aufrufer den Speicher bereitstellt. Der Speicher muss 4-Byte auf 32-Bit-Plattformen ausgerichtet und 8 Byte auf 64-Bit-Plattformen ausgerichtet sein.

[in] Level

Reserviert. Treiber legen dies auf 0 (null) fest.

Rückgabewert

Keine

Bemerkungen

Verwenden Sie schnelle Mutexe oder geschützte Mutexe, um eine bessere Leistung zu erzielen. Weitere Informationen finden Sie unter Alternativen zu Mutex-Objekten.

Das Mutex-Objekt wird mit einem anfangs signalisierten Zustand initialisiert.

Der Speicher für ein Mutex-Objekt muss resident sein: in der Geräteerweiterung eines vom Treiber erstellten Geräteobjekts, in der Controllererweiterung eines vom Treiber erstellten Controllerobjekts oder in einem nicht ausgelagerten Pool, der vom Aufrufer zugeordnet wird.

Weitere Informationen zu Mutex-Objekten finden Sie unter Mutex-Objekte.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar ab Windows 2000.
Zielplattform Universell
Header wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe
IRQL Beliebige Ebene
DDI-Complianceregeln HwStorPortProhibitedDIs(storport)

Weitere Informationen

ExInitializeFastMutex

KeReadStateMutex

KeReleaseMutex

KeWaitForMultipleObjects

KeWaitForSingleObject