Freigeben über


ExInitializeFastMutex-Funktion (wdm.h)

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

Weitere Informationen

ExAcquireFastMutex

ExAcquireFastMutexUnsafe

ExReleaseFastMutex

ExReleaseFastMutexUnsafe

ExTryToAcquireFastMutex

FAST_MUTEX

KeInitializeMutex