Fonction IoGetNextIrpStackLocation (wdm.h)

Article
02/27/2024

La routine IoGetNextIrpStackLocation permet à un pilote de niveau supérieur d’accéder à l’emplacement de pile d’E/S du pilote inférieur suivant dans un IRP afin que l’appelant puisse le configurer pour le pilote inférieur.

Syntaxe

__drv_aliasesMem PIO_STACK_LOCATION IoGetNextIrpStackLocation(
  [in] PIRP Irp
);

Paramètres

[in] Irp

Pointeur vers l’IRP.

Valeur retournée

IoGetNextIrpStackLocation retourne un pointeur vers l’emplacement de la pile d’E/S du pilote de niveau inférieur suivant dans l’IRP donné.

Remarques

Chaque pilote qui transmet des IRPs à des pilotes inférieurs doit configurer l’emplacement de la pile pour le pilote inférieur suivant. Un pilote appelle IoGetNextIrpStackLocation pour obtenir un pointeur vers l’emplacement de la pile d’E/S du pilote inférieur suivant.

Si un pilote transmet les mêmes paramètres qu’il a reçus au pilote inférieur suivant, il doit appeler IoCopyCurrentIrpStackLocationToNext ou IoSkipCurrentIrpStackLocation au lieu d’obtenir un pointeur vers l’emplacement de pile inférieur suivant et de copier les paramètres manuellement.

La valeur de retour est un pointeur vers une structure IO_STACK_LOCATION . Pour plus d’informations, consultez Emplacements de pile d’E/S.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 2000.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h)
IRQL	N’importe quel niveau