Partager via


IoCopyCurrentIrpStackLocationToNext, fonction (wdm.h)

La routine IoCopyCurrentIrpStackLocationToNext copie les paramètres de pile IRP de l’emplacement actuel de la pile d’E/S vers l’emplacement de la pile de la pile suivante.

Syntaxe

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

Paramètres

[in, out] Irp

Pointeur vers l’IRP.

Valeur de retour

Aucun

Remarques

Un pilote appelle IoCopyCurrentIrpStackLocationToNext pour copier les paramètres IRP de son emplacement de pile vers l’emplacement de la pile suivante du pilote.

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 passent leurs paramètres IRP, mais qui ne définissent pas de routine d’achèvement d’E/S, doivent appeler IoSkipCurrentIrpStackLocation au lieu de cette routine.

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

Exigences

Exigence Valeur
client minimum pris en charge Disponible à partir de Windows 2000.
plateforme cible Bureau
d’en-tête wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
IRQL <=DISPATCH_LEVEL

Voir aussi

IO_STACK_LOCATION

IoCallDriver

IoMarkIrpPending

IoSetCompletionRoutine

IoSkipCurrentIrpStackLocation