KeEnterCriticalRegion-Funktion (wdm.h)
Die KeEnterCriticalRegion-Routine deaktiviert vorübergehend die Ausführung normaler Kernel-APCs, verhindert jedoch nicht, dass spezielle Kernel-APCs ausgeführt werden.
Syntax
void KeEnterCriticalRegion();
Rückgabewert
Keine
Bemerkungen
Ein Treiber ruft diese Routine auf, um in einen kritischen Bereich zu gelangen, in dem die Ausführung normaler Kernel-APCs verzögert wird, bis dieser Treiber den kritischen Bereich durch Aufrufen der KeLeaveCriticalRegion-Routine verlässt. Jeder Aufrufer von KeEnterCriticalRegion sollte KeLeaveCriticalRegion so schnell wie möglich aufrufen, nachdem er eine kritische Region betreten hat.
Treiber der obersten Ebene können KeEnterCriticalRegion aufrufen, während sie im Kontext des Threads ausgeführt werden, der den aktuellen E/A-Vorgang angefordert hat.
Für einen Thread, der sich in einer kritischen Region befindet, sind sowohl Benutzer-APCs als auch normale Kernel-APCs deaktiviert, aber keine speziellen Kernel-APCs. Weitere Informationen zu diesen APC-Typen finden Sie unter Typen von APCs.
Kritische Regionen können rekursiv eingegeben werden, und jeder Aufruf von KeEnterCriticalRegion muss über einen entsprechenden Aufruf von KeLeaveCriticalRegion verfügen.
Ein Treiber kann eine kritische Region verwenden, um exklusiven Zugriff auf eine freigegebene Ressource zu erhalten und freizugeben. In diesem Fall können die Routinen ExEnterCriticalRegionAndAcquireResourceExclusive und ExReleaseResourceAndLeaveCriticalRegion anstelle der Routinen KeEnterCriticalRegion und KeLeaveCriticalRegion verwendet werden. Weitere Informationen finden Sie im Codebeispiel in ExEnterCriticalRegionAndAcquireResourceExclusive.
Weitere Informationen zu APCs finden Sie unter Asynchrone Prozeduraufrufe.
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 | <= APC_LEVEL |
| DDI-Complianceregeln | CriticalRegions(wdm), HwStorPortProhibitedDIs(storport), IrqlKeApcLte2(wdm), WithinCriticalRegion(storport), WithinCriticalRegion(storport), WithinCriticalRegion(wdm) |
Weitere Informationen
ExEnterCriticalRegionAndAcquireResourceExclusive