Fonction IoCopyCurrentIrpStackLocationToNext (wdm.h)

  • Article

La routine IoCopyCurrentIrpStackLocationToNext copie les paramètres de pile IRP de l’emplacement de pile d’E/S actuel vers l’emplacement de pile du pilote inférieur suivant.

Syntaxe

void IoCopyCurrentIrpStackLocationToNext(
  [in, out] PIRP Irp
);

Paramètres

[in, out] Irp

Pointeur vers l’IRP.

Valeur de retour

None

Remarques

Un pilote appelle IoCopyCurrentIrpStackLocationToNext pour copier les paramètres IRP de son emplacement de pile vers l’emplacement de pile du pilote inférieur suivant.

Après avoir appelé cette routine, un pilote définit généralement une routine d’achèvement d’E/S avec IoSetCompletionRoutine avant de passer l’IRP au pilote inférieur suivant avec IoCallDriver. Les pilotes qui transmettent leurs paramètres IRP mais ne définissent pas de routine d’achèvement des E/S doivent appeler IoSkipCurrentIrpStackLocation à la place de cette routine.

Si votre pilote appelle IoSkipCurrentIrpStackLocation, veillez à ne pas modifier la structure IO_STACK_LOCATION d’une manière susceptible d’affecter involontairement le pilote inférieur ou le comportement du système par rapport à ce pilote. En particulier, votre pilote ne doit pas modifier l’union paramètres de la structure IO_STACK_LOCATION et ne doit pas appeler la routine IoMarkIrpPending.

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 (include Wdm.h, Ntddk.h, Ntifs.h)
IRQL <=DISPATCH_LEVEL

Voir aussi

IO_STACK_LOCATION

IoCallDriver

IoMarkIrpPending

IoSetCompletionRoutine

IoSkipCurrentIrpStackLocation