Funzione FltUnloadFilter (fltkernel.h)

Un driver minifilter che ha caricato un driver minifilter di supporto chiamando FltLoadFilter può scaricare il driver minifilter 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 minifilter 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 minifilter corrispondente, ma è già stato distrutto. 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.

Commenti

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

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.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Intestazione	fltkernel.h (includere Fltkernel.h)
Libreria	FltMgr.lib
DLL	Fltmgr.sys
IRQL	PASSIVE_LEVEL

Vedi anche

FltLoadFilter

PFLT_FILTER_UNLOAD_CALLBACK

UNICODE_STRING