Funzione IoCancelIrp (wdm.h)

La routine IoCancelIrp imposta il bit di annullamento in un determinato IRP e chiama la routine di annullamento per l'IRP se ne esiste una.

Sintassi

BOOLEAN IoCancelIrp(
  [in] PIRP Irp
);

Parametri

[in] Irp

Puntatore all'IRP da annullare.

Valore restituito

IoCancelIrp restituisce TRUE se l'IRP aveva una routine di annullamento e questa routine è stata chiamata. In caso contrario, restituisce FALSE. In entrambi i casi, il bit di annullamento dell'IRP è impostato su TRUE. Per altre informazioni, vedere la sezione Osservazioni.

Commenti

Se L'IRP ha una routine di annullamento, IoCancelIrp imposta il bit annulla e chiama la routine annulla.

Se Irp-CancelRoutine> è NULL e pertanto l'IRP non è annullabile, IoCancelIrp imposta il bit di annullamento dell'IRP e restituisce FALSE. L'IRP deve essere annullato in un secondo momento quando diventa annullabile.

Se un driver che non possiede l'IRP chiama IoCancelIrp, i risultati sono imprevedibili. L'IRP potrebbe essere completato con uno stato di esito positivo anche se il relativo bit di annullamento è stato impostato.

Un driver intermedio non deve chiamare arbitrariamente IoCancelIrp a meno che il driver creato l'IRP passato nella chiamata. In caso contrario, il driver intermedio potrebbe annullare un'IRP che un driver di livello superiore sta monitorando a scopo proprio.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 2000.
Piattaforma di destinazione	Universale
Intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL
Regole di conformità DDI	HwStorPortProhibitedDDDIs(storport)

Vedi anche

IoSetCancelRoutine