Freigeben über


FltUnloadFilter-Funktion (fltkernel.h)

Ein Minifiltertreiber, der einen unterstützenden Minifiltertreiber geladen hat, indem FltLoadFilter- aufgerufen wird, kann den Minifiltertreiber entladen, indem FltUnloadFilteraufgerufen wird.

Syntax

NTSTATUS FLTAPI FltUnloadFilter(
  [in] PCUNICODE_STRING FilterName
);

Parameter

[in] FilterName

Zeiger auf eine UNICODE_STRING Struktur mit dem Namen des Minifiltertreiberdiensts, der an FltLoadFilter-übergeben wurde.

Rückgabewert

FltUnloadFilter gibt STATUS_SUCCESS oder einen geeigneten NTSTATUS-Wert zurück, z. B. einen der folgenden:

Rückgabecode Beschreibung
STATUS_FLT_DELETING_OBJECT
Es wurde ein passender Minifiltertreiber gefunden, aber er wird bereits heruntergerissen. Dies ist ein Fehlercode.
STATUS_FLT_FILTER_NOT_FOUND
Es wurde kein übereinstimmener Minifiltertreiber gefunden. Dies ist ein Fehlercode.

Bemerkungen

Ein Minifiltertreiber, der von einem anderen Minifiltertreiber abhängig ist, kann diesen Minifiltertreiber entladen, indem er FltUnloadFilter-aufruft. Diese Routine sucht nach einem registrierten Minifiltertreiber, dessen Dienstname dem angegebenen FilterName- entspricht, und ruft die FilterUnloadCallback- (PFLT_FILTER_UNLOAD_CALLBACK) -Routine des Minifiltertreibers auf.

Wenn der unterstützende Minifiltertreiber keine FilterUnloadCallback- Routine registriert hat, schlägt der Aufruf von FltUnloadFilter fehl.

Ein Minifiltertreiber kann FltUnloadFilter- nicht aufrufen, um sich selbst zu entladen.

Anforderungen

Anforderung Wert
Zielplattform- Universal
Header- fltkernel.h (include Fltkernel.h)
Library FltMgr.lib
DLL- Fltmgr.sys
IRQL- PASSIVE_LEVEL

Siehe auch

FltLoadFilter-

PFLT_FILTER_UNLOAD_CALLBACK

UNICODE_STRING