Funzione FltSetCancelCompletion (fltkernel.h)

Articolo
02/26/2024

Un driver minifilter chiama FltSetCancelCompletion per specificare una routine di annullamento da chiamare se un'operazione di I/O specificata viene annullata.

Sintassi

NTSTATUS FLTAPI FltSetCancelCompletion(
  [in] PFLT_CALLBACK_DATA              CallbackData,
  [in] PFLT_COMPLETE_CANCELED_CALLBACK CanceledCallback
);

Parametri

[in] CallbackData

Puntatore alla struttura dei dati di callback (FLT_CALLBACK_DATA) per l'operazione di I/O. L'operazione deve essere un'operazione di I/O basata su IRP e non deve essere un'operazione di I/O di paging. Per determinare se una determinata struttura di dati di callback rappresenta un'operazione di I/O basata su IRP, utilizzare la macro FLT_IS_IRP_OPERATION . Questo parametro è obbligatorio e non può essere NULL.

[in] CanceledCallback

Puntatore a una routine di annullamento fornita dal chiamante. Gestione filtri chiama questa routine se l'operazione di I/O rappresentata da CallbackData viene annullata.

Questa routine viene dichiarata come segue:

typedef VOID
(*PFLT_COMPLETE_CANCELED_CALLBACK) (
      IN PFLT_CALLBACK_DATA CallbackData
      );

CallbackData

Puntatore alla struttura FLT_CALLBACK_DATA per l'operazione di I/O.

Valore restituito

FltSetCancelCompletion restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato.

Commenti

FltSetCancelCompletion specifica una routine di annullamento per un'operazione di I/O basata su IRP da pubblicare in una coda di lavoro.

I driver minifilter in genere chiamano FltSetCancelCompletion per un'operazione di I/O immediatamente prima di chiamare FltQueueDeferredIoWorkItem per pubblicare l'operazione in una coda di lavoro.

Non chiamare FltSetCancelCompletion per qualsiasi operazione di I/O che deve essere inviata a una coda di dati di callback annullata usando le routine FltCbdqXxx .

Gestione filtri chiama la routine CanceledCallback senza tenere premuto il blocco spin di annullamento del sistema o eseguire qualsiasi altra sincronizzazione. Qualsiasi sincronizzazione necessaria deve essere fornita dal driver minifilter stesso.

Per annullare un'operazione di I/O, chiamare FltCancelIo.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Intestazione	fltkernel.h (include Fltkernel.h)
Libreria	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= DISPATCH_LEVEL