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