Fonction IoGetTopLevelIrp (wdm.h)

  • Article

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 wdm.h (inclure Ntifs.h, Wdm.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL

Voir aussi

IoSetTopLevelIrp