Freigeben über


KeInitializeMutex-Funktion (wdm.h)

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

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 auf 32-Bit-Plattformen ausgerichtet sein und 8-Byte auf 64-Bit-Plattformen ausgerichtet sein.

[in] Level

Reserviert. Dies wird von Treibern auf Null festgelegt.

Rückgabewert

Nichts

Bemerkungen

Um eine bessere Leistung zu erzielen, verwenden Sie schnelle Mutexe oder geschützte Mutexe. Weitere Informationen finden Sie unter Alternativen zu Mutex Objects.

Das Mutex-Objekt wird mit einem anfänglichen Signalzustand initialisiert.

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 im vom Aufrufer zugewiesenen nicht ausgelagerten Pool.

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

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Ab Windows 2000 verfügbar.
Zielplattform- Universal
Header- wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
DLL- NtosKrnl.exe
IRQL- Beliebige Ebene
DDI-Complianceregeln HwStorPortProhibitedDIs(storport)

Siehe auch

ExInitializeFastMutex

KeReadStateMutex

KeReleaseMutex

KeWaitForMultipleObjects

KeWaitForSingleObject