Funzione FltCancelIo (fltkernel.h)

Articolo
02/26/2024

La routine FltCancelIo annulla un'operazione di I/O.

Sintassi

BOOLEAN FLTAPI FltCancelIo(
  [in] PFLT_CALLBACK_DATA CallbackData
);

Parametri

[in] CallbackData

Puntatore alla struttura dei dati di callback (FLT_CALLBACK_DATA) per l'operazione di I/O.

Valore restituito

FltCancelIo restituisce TRUE se l'operazione di I/O è stata annullata correttamente. In caso contrario, restituisce FALSE.

Commenti

Un driver minifilter che avvia un'operazione di I/O chiamando una routine come FltPerformAsynchronousIo può annullare l'operazione chiamando FltCancelIo. L'operazione deve essere un'operazione di I/O basata su IRP, non deve essere attualmente pubblicata nella coda di lavoro del driver minifilter e non deve essere stata completata.

Se l'IRP ha una routine di annullamento, FltCancelIo imposta il bit di annullamento dell'IRP e chiama la routine annulla.

Se l'IRP non ha una routine di annullamento e quindi l'IRP non è annullabile, FltCancelIo 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 minifilter che non ha avviato l'operazione di I/O basata su IRP chiama FltCancelIo, i risultati sono imprevedibili. Ad esempio, l'IRP potrebbe essere completato con un codice NTSTATUS riuscito anche se il relativo bit di annullamento è stato impostato.

FltCancelIo restituisce FALSE se una delle condizioni seguenti è true: