Freigeben über


ExInitializeFastMutex-Funktion (wdm.h)

Die ExInitializeFastMutex Routine initialisiert eine schnelle Mutex-Variable, die verwendet wird, um den sich gegenseitig ausschließenden Zugriff durch eine Reihe von Threads mit einer freigegebenen Ressource zu synchronisieren.

Syntax

void ExInitializeFastMutex(
  [out] PFAST_MUTEX FastMutex
);

Parameter

[out] FastMutex

Ein Zeiger auf eine vom Aufrufer zugewiesene FAST_MUTEX Struktur, die den schnellen Mutex darstellt, im nichtpageten Speicherpool. Die Zuweisung muss auf 32-Bit-Plattformen ausgerichtet sein und 8-Byte auf 64-Bit-Plattformen ausgerichtet sein.

Rückgabewert

Nichts

Bemerkungen

ExInitializeFastMutex- müssen aufgerufen werden, bevor Aufrufe an andere ExXxxFastMutex Routinen auftreten.

Obwohl der Aufrufer den Speicher für den gegebenen schnellen Mutex bereitstellt, ist die FAST_MUTEX Struktur undurchsichtig: d. h., die Member sind für die Systemverwendung reserviert.

Verwenden Sie für eine bessere Leistung die ExXxxFastMutex Routinen anstelle der KeXxxMutex Routinen. Ein schneller Mutex kann jedoch nicht rekursiv erworben werden, da ein Kernel-Mutex möglich ist.

Weitere Informationen zu schnellen Mutexen finden Sie unter Fast Mutexes und Guarded Mutexes.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Ab Windows 2000 verfügbar.
Zielplattform- Desktop
Header- wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
DLL- NtosKrnl.exe
IRQL- <= DISPATCH_LEVEL

Siehe auch

ExAcquireFastMutex

ExAcquireFastMutexUnsafe-

ExReleaseFastMutex

ExReleaseFastMutexUnsafe

ExTryToAcquireFastMutex

FAST_MUTEX

KeInitializeMutex