Fonction IoGetTopLevelIrp (ntifs.h)
La routine IoGetTopLevelIrp retourne la valeur du champ TopLevelIrp du thread actif.
Syntaxe
PIRP IoGetTopLevelIrp();
Valeur de retour
IoGetTopLevelIrp retourne la valeur du champ TopLevelIrp du thread actif.
Remarques
IoGetTopLevelIrp peut retourner NULL, une valeur arbitraire spécifique au système de fichiers (comme un pointeur vers l’IRP actuel) ou l’un des indicateurs répertoriés dans le tableau suivant.
Si le thread actuel ne contient aucune ressource au-dessus du système de fichiers, IoGetTopLevelIrp retourne NULL.
Si le système de fichiers est le composant de niveau supérieur du thread actif, IoGetTopLevelIrp retourne un pointeur vers l’IRP actuel.
Si un composant autre que le système de fichiers est le composant de niveau supérieur du thread actif, IoGetTopLevelIrp retourne l’un des indicateurs suivants :
| Indicateur | Signification |
|---|---|
| FSRTL_FSP_TOP_LEVEL_IRP | Il s’agit d’un appel récursif. |
| FSRTL_CACHE_TOP_LEVEL_IRP | Le gestionnaire de cache est le composant de niveau supérieur du thread actuel. |
| FSRTL_MOD_WRITE_TOP_LEVEL_IRP | L’enregistreur de page modifié est le composant de niveau supérieur du thread actif. |
| FSRTL_FAST_IO_TOP_LEVEL_IRP | Le gestionnaire de cache est le composant de niveau supérieur du thread actuel, et le thread actuel se trouve dans un chemin d’E/S rapide. |
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| En-tête | ntifs.h (inclure Ntifs.h, Wdm.h) |
| Bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |