Freigeben über


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 Status des Mutex-Objekts signalisiert.

Bemerkungen

Diese Routine bietet eine effiziente Möglichkeit, den Signalzustand eines Mutex abzufragen. KeReadStateMutex liest den Status des Mutex vor, ohne den Zugriff auf den Mutex zu synchronisieren. Gehen Sie nicht davon aus, dass der Zugriff auf einen Mutex-Zustand durch KeReadStateMutex- sich gegenseitig von Zugriffen durch 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 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- <= DISPATCH_LEVEL
DDI-Complianceregeln HwStorPortProhibitedDIs(storport)

Siehe auch

ExInitializeFastMutex

KeInitializeMutex

KeReleaseMutex

KeWaitForSingleObject