Функция IoCancelIrp (wdm.h)

Подпрограмма IoCancelIrp задает бит отмены в заданном IRP и вызывает подпрограмму отмены для IRP, если она есть.

Синтаксис

BOOLEAN IoCancelIrp(
  [in] PIRP Irp
);

Параметры

[in] Irp

Указатель на IRP, который требуется отменить.

Возвращаемое значение

IoCancelIrp возвращает значение TRUE , если в IRP была отменена процедура и эта процедура была вызвана. В противном случае возвращается значение FALSE. В любом случае бит отмены IRP имеет значение TRUE. Дополнительные сведения см. в подразделе "Примечания".

Комментарии

Если IRP имеет подпрограмму отмены, IoCancelIrp задает бит отмены и вызывает подпрограмму отмены.

Если параметр Irp-CancelRoutine> имеет значение NULL и, следовательно, IRP не может быть отменен, IoCancelIrp задает бит отмены IRP и возвращает значение FALSE. IRP следует отменить позже, когда он станет отменяемым.

Если драйвер, не владеющий IRP, вызывает IoCancelIrp, результаты будут непредсказуемыми. IRP может быть завершен с состоянием успешного выполнения, даже если задан его бит отмены.

Промежуточный драйвер не должен произвольно вызывать IoCancelIrp , если только этот драйвер не создал IRP, переданный в вызове. В противном случае промежуточный драйвер может отменить IRP, который отслеживает драйвер более высокого уровня для собственных целей.

Требования

См. также раздел

IoSetCancelRoutine