KeReadStateMutex-Funktion (wdm.h)

Die KeReadStateMutex-Routine gibt den aktuellen Zustand (signalisiert oder nicht signalisiert) des angegebenen Mutex-Objekts zurück.

Syntax

LONG KeReadStateMutex(
  [in] PRKMUTEX Mutex
);

Parameter

[in] Mutex

Zeiger auf ein initialisiertes Mutex-Objekt, für das der Aufrufer den Speicher bereitstellt.

Rückgabewert

Wenn der Rückgabewert 1 ist, wird der Zustand des Mutex-Objekts signalisiert.

Hinweise

Diese Routine bietet eine effiziente Möglichkeit, den Signalzustand eines Mutex abzufragen. KeReadStateMutex liest den Status des Mutex, ohne den Zugriff auf den Mutex zu synchronisieren. Gehen Sie nicht davon aus, dass Zugriffe auf einen Mutex-Zustand durch KeReadStateMutex gegenseitig den Zugriff von Routinen ausschließen, z. B. KeReleaseMutex und KeWaitForSingleObject, die ihren Zugriff auf den Mutex-Zustand synchronisieren.

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	<= DISPATCH_LEVEL
DDI-Complianceregeln	HwStorPortProhibitedDIs(storport)

Weitere Informationen

ExInitializeFastMutex

KeInitializeMutex

KeReleaseMutex

KeWaitForSingleObject