KeReadStateSemaphore-Funktion (wdm.h)
Die KeReadStateSemaphore-Routine gibt den aktuellen Zustand des angegebenen Semaphorobjekts zurück, der signalisiert oder nicht signalisiert ist.
Syntax
LONG KeReadStateSemaphore(
[in] PRKSEMAPHORE Semaphore
);
Parameter
[in] Semaphore
Zeiger auf ein initialisiertes Semaphorobjekt, für das der Aufrufer den Speicher bereitstellt.
Rückgabewert
Wenn der Rückgabewert 0 ist, wird das Semaphorobjekt auf einen nicht signalgeschützten Zustand festgelegt.
Hinweise
Diese Routine bietet eine effiziente Möglichkeit, den Signalzustand eines Semaphors abzufragen. KeReadStateSemaphor liest den Zustand des Semaphors, ohne seinen Zugriff auf den Semaphor zu synchronisieren. Gehen Sie nicht davon aus, dass der Zugriff auf einen Semaphorzustand durch KeReadStateSemaphor sich gegenseitig von Routinen wie KeReleaseSemaphore und KeWaitForSingleObject ausschließt, die ihren Zugriff auf den Semaphorzustand synchronisieren.
Weitere Informationen zu Semaphorobjekten finden Sie unter Semaphor-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 | Beliebige Ebene |
| DDI-Complianceregeln | HwStorPortProhibitedDDIs(storport) |