FltUnloadFilter-Funktion (fltkernel.h)
Ein Minifiltertreiber, der einen unterstützenden Minifiltertreiber geladen hat, indem Er FltLoadFilter aufruft , kann den Minifiltertreiber entladen, indem er FltUnloadFilter aufruft.
Syntax
NTSTATUS FLTAPI FltUnloadFilter(
[in] PCUNICODE_STRING FilterName
);
Parameter
[in] FilterName
Zeiger auf eine UNICODE_STRING-Struktur , die den Namen des Minifiltertreiberdiensts enthält, der an FltLoadFilter übergeben wurde.
Rückgabewert
FltUnloadFilter gibt STATUS_SUCCESS oder einen entsprechenden NTSTATUS-Wert zurück, z. B. einen der folgenden:
| Rückgabecode | Beschreibung |
|---|---|
|
Es wurde ein passender Minifiltertreiber gefunden, der jedoch bereits abgerissen wurde. Dies ist ein Fehlercode. |
|
Es wurde kein passender Minifiltertreiber gefunden. Dies ist ein Fehlercode. |
Hinweise
Ein Minifiltertreiber, der eine Abhängigkeit von einem anderen Minifiltertreiber aufweist, kann diesen Minifiltertreiber entladen, indem Er FltUnloadFilter aufruft. Diese Routine sucht nach einem registrierten Minifiltertreiber, dessen Dienstname mit dem angegebenen FilterName übereinstimmt, und ruft die FilterUnloadCallback-Routine (PFLT_FILTER_UNLOAD_CALLBACK) dieses 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 | Universell |
| Header | fltkernel.h (include Fltkernel.h) |
| Bibliothek | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | PASSIVE_LEVEL |