Fonction IoGetTopLevelIrp (wdm.h)
La routine IoGetTopLevelIrp retourne la valeur du champ TopLevelIrp du thread actuel.
Syntaxe
PIRP IoGetTopLevelIrp();
Valeur de retour
IoGetTopLevelIrp retourne la valeur du champ TopLevelIrp du thread actuel.
Remarques
IoGetTopLevelIrp pouvez retourner NULL, une valeur arbitraire spécifique au système de fichiers (par exemple, 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 actuel, 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 actuel, IoGetTopLevelIrp retourne l’un des indicateurs suivants :
| Drapeau | 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 pages modifié est le composant de niveau supérieur du thread actuel. |
| 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. |
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | wdm.h (include Ntifs.h, Wdm.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |