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