Fonction IoCancelIrp (wdm.h)

  • Article

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

Condition requise Valeur
Client minimal pris en charge Disponible à partir de Windows 2000.
Plateforme cible Universal
En-tête wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL
Règles de conformité DDI HwStorPortProhibitedDDIs(storport)

Voir aussi

IoSetCancelRoutine