ExInitializeFastMutex-Funktion (wdm.h)

Artikel
02/27/2024

Die ExInitializeFastMutex-Routine initialisiert eine schnelle Mutex-Variable, die verwendet wird, um den sich gegenseitig ausschließenden Zugriff einer Gruppe 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 nicht auslagerten Arbeitsspeicherpool. Die Zuordnung muss 4 Byte auf 32-Bit-Plattformen und 8 Byte auf 64-Bit-Plattformen ausgerichtet sein.

Rückgabewert

Keine

Bemerkungen

ExInitializeFastMutex muss aufgerufen werden, bevor Aufrufe anderer ExXxxFastMutex-Routinen auftreten.

Obwohl der Aufrufer den Speicher für den angegebenen schnellen Mutex bereitstellt, ist die FAST_MUTEX-Struktur undurchsichtig: Das heißt, ihre Member sind für die Systemnutzung reserviert.

Verwenden Sie die ExXxxFastMutex-Routinen anstelle der KeXxxMutex-Routinen , um eine bessere Leistung zu erzielen. Ein schneller Mutex kann jedoch nicht rekursiv erworben werden, wie ein Kernel-Mutex.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 2000.
Zielplattform	Desktop
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL