Fonction IoCopyCurrentIrpStackLocationToNext (wdm.h)
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 |