FltUnloadFilter function (fltkernel.h)
A minifilter driver that has loaded a supporting minifilter driver by calling FltLoadFilter can unload the minifilter driver by calling FltUnloadFilter.
Syntax
NTSTATUS FLTAPI FltUnloadFilter(
[in] PCUNICODE_STRING FilterName
);
Parameters
[in] FilterName
Pointer to a UNICODE_STRING structure containing the minifilter driver service name that was passed to FltLoadFilter.
Return value
FltUnloadFilter returns STATUS_SUCCESS or an appropriate NTSTATUS value such as one of the following:
| Return code | Description |
|---|---|
|
A matching minifilter driver was found, but it is already being torn down. This is an error code. |
|
No matching minifilter driver was found. This is an error code. |
Remarks
A minifilter driver that has a dependency on another minifilter driver can unload that minifilter driver by calling FltUnloadFilter. This routine searches for a registered minifilter driver whose service name matches the given FilterName and calls that minifilter driver's FilterUnloadCallback (PFLT_FILTER_UNLOAD_CALLBACK) routine.
If the supporting minifilter driver did not register a FilterUnloadCallback routine, the call to FltUnloadFilter fails.
A minifilter driver cannot call FltUnloadFilter to unload itself.
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Universal |
| Header | fltkernel.h (include Fltkernel.h) |
| Library | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | PASSIVE_LEVEL |