FltUnloadFilter function

A minifilter driver that has loaded a supporting minifilter driver by calling FltLoadFilter can unload the minifilter driver by calling FltUnloadFilter.

Syntax


NTSTATUS FltUnloadFilter(
  _In_ PCUNICODE_STRING FilterName
);

Parameters

FilterName [in]

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 codeDescription
STATUS_FLT_DELETING_OBJECT

A matching minifilter driver was found, but it is already being torn down. This is an error code.

STATUS_FLT_FILTER_NOT_FOUND

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

Target platform

Universal

Header

Fltkernel.h (include Fltkernel.h)

Library

FltMgr.lib

DLL

Fltmgr.sys

IRQL

PASSIVE_LEVEL

See also

FltLoadFilter
PFLT_FILTER_UNLOAD_CALLBACK
UNICODE_STRING

 

 

Send comments about this topic to Microsoft

Show: