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) |