Condividi tramite


Funzione FltUnloadFilter (fltkernel.h)

Un driver minifiltro che ha caricato un driver minifiltro di supporto chiamando FltLoadFilter può scaricare il driver minifiltro chiamando FltUnloadFilter.

Sintassi

NTSTATUS FLTAPI FltUnloadFilter(
  [in] PCUNICODE_STRING FilterName
);

Parametri

[in] FilterName

Puntatore a una struttura UNICODE_STRING contenente il nome del servizio driver minifiltro passato a FltLoadFilter.

Valore restituito

FltUnloadFilter restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato, ad esempio uno dei seguenti:

Codice restituito Descrizione
STATUS_FLT_DELETING_OBJECT
È stato trovato un driver minifiltro corrispondente, ma è già in corso l'interruzione. Si tratta di un codice di errore.
STATUS_FLT_FILTER_NOT_FOUND
Non è stato trovato alcun driver minifilter corrispondente. Si tratta di un codice di errore.

Osservazioni

Un driver minifiltro che ha una dipendenza da un altro driver minifiltro può scaricare il driver minifiltro chiamando FltUnloadFilter. Questa routine cerca un driver minifiltro registrato il cui nome del servizio corrisponde alla FilterName specificata e chiama la routine filterUnloadCallback (PFLT_FILTER_UNLOAD_CALLBACK) del driver minifilter.

Se il driver minifilter di supporto non ha registrato una routine FilterUnloadCallback, la chiamata a FltUnloadFilter ha esito negativo.

Un driver minifilter non può chiamare FltUnloadFilter per scaricare se stesso.

Fabbisogno

Requisito Valore
piattaforma di destinazione Universale
intestazione fltkernel.h (include Fltkernel.h)
libreria FltMgr.lib
dll Fltmgr.sys
IRQL PASSIVE_LEVEL

Vedere anche

FltLoadFilter

PFLT_FILTER_UNLOAD_CALLBACK

UNICODE_STRING