IoGetTopLevelIrp-Funktion (ntifs.h)
Die IoGetTopLevelIrp-Routine gibt den Wert des TopLevelIrp-Felds des aktuellen Threads zurück.
Syntax
PIRP IoGetTopLevelIrp();
Rückgabewert
IoGetTopLevelIrp gibt den Wert des TopLevelIrp-Felds des aktuellen Threads zurück.
Hinweise
IoGetTopLevelIrp kann NULL, einen beliebigen dateisystemspezifischen Wert (z. B. einen Zeiger auf das aktuelle IRP) oder eines der in der folgenden Tabelle aufgeführten Flags zurückgeben.
Wenn der aktuelle Thread keine Ressourcen über dem Dateisystem enthält, gibt IoGetTopLevelIrpNULL zurück.
Wenn das Dateisystem die Komponente der obersten Ebene für den aktuellen Thread ist, gibt IoGetTopLevelIrp einen Zeiger auf den aktuellen IRP zurück.
Wenn eine andere Komponente als das Dateisystem die Komponente der obersten Ebene für den aktuellen Thread ist, gibt IoGetTopLevelIrp eines der folgenden Flags zurück:
| Flag | Bedeutung |
|---|---|
| FSRTL_FSP_TOP_LEVEL_IRP | Dies ist ein rekursiver Aufruf. |
| FSRTL_CACHE_TOP_LEVEL_IRP | Der Cache-Manager ist die Komponente der obersten Ebene für den aktuellen Thread. |
| FSRTL_MOD_WRITE_TOP_LEVEL_IRP | Der geänderte Seitenschreiber ist die Komponente der obersten Ebene für den aktuellen Thread. |
| FSRTL_FAST_IO_TOP_LEVEL_IRP | Der Cache-Manager ist die Komponente der obersten Ebene für den aktuellen Thread, und der aktuelle Thread befindet sich in einem schnellen E/A-Pfad. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| Header | ntifs.h (include Ntifs.h, Wdm.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |