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 |
|---|---|
|
Es wurde ein passender Minifiltertreiber gefunden, aber er wird bereits heruntergerissen. Dies ist ein Fehlercode. |
|
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 |