Funzione FltFreeCallbackData (fltkernel.h)

Articolo
02/29/2024

La routine FltFreeCallbackData libera una struttura di dati di callback allocata dalla routine FltAllocateCallbackData .

Sintassi

VOID FLTAPI FltFreeCallbackData(
  [in] PFLT_CALLBACK_DATA CallbackData
);

Parametri

[in] CallbackData

Puntatore alla struttura dei dati di callback da liberare. Questa struttura FLT_CALLBACK_DATA deve essere stata allocata da una chiamata precedente a FltAllocateCallbackData. Questo parametro è obbligatorio e non può essere NULL.

Valore restituito

nessuno

Osservazioni

Un driver minifilter deve usare FltFreeCallbackData solo su una struttura di dati di callback (FLT_CALLBACK_DATA) allocata in precedenza con FltAllocateCallbackData e usata in una chiamata a FltPerformAsynchronousIo o FltPerformSynchronousIo.

In particolare, un driver minifilter non deve usare questa routine per le strutture di dati di callback non allocate dal driver minifilter stesso.

La routine FltFreeCallbackData libera qualsiasi catena MDL associata all'oggetto CallbackData fornito. Un puntatore a una catena MDL associata a un oggetto FLT_CALLBACK_DATA non sarà valido dopo una chiamata a FltFreeCallbackData per tale oggetto.