Fonction IoCancelIrp (wdm.h)

La routine IoCancelIrp définit le bit d’annulation dans un IRP donné et appelle la routine d’annulation pour l’IRP, le cas échéant.

Syntaxe

BOOLEAN IoCancelIrp(
  [in] PIRP Irp
);

Paramètres

[in] Irp

Pointeur vers l’IRP à annuler.

Valeur retournée

IoCancelIrp retourne TRUE si l’IRP avait une routine d’annulation et que cette routine a été appelée. Sinon, elle retourne FALSE. Dans les deux cas, le bit d’annulation de l’IRP est défini sur TRUE. Pour plus d'informations, consultez la section Notes.

Remarques

Si l’IRP a une routine d’annulation, IoCancelIrp définit le bit d’annulation et appelle la routine d’annulation.

Si Irp-CancelRoutine> a la valeur NULL et que, par conséquent, l’IRP n’est pas annulable, IoCancelIrp définit le bit d’annulation de l’IRP et retourne FALSE. L’IRP doit être annulé ultérieurement lorsqu’il devient annulable.

Si un pilote qui ne possède pas l’IRP appelle IoCancelIrp, les résultats sont imprévisibles. L’IRP peut être terminé avec un status réussi même si son bit d’annulation a été défini.

Un pilote intermédiaire ne doit pas appeler arbitrairement IoCancelIrp , sauf si ce pilote a créé l’IRP passé dans l’appel. Dans le cas contraire, le pilote intermédiaire peut annuler une IRP que certains pilotes de niveau supérieur effectuent le suivi à des fins propres.

Configuration requise

Voir aussi

IoSetCancelRoutine