FltLoadFilter routine

The FltLoadFilter routine dynamically loads a minifilter driver into the currently running system.

Syntax


NTSTATUS FltLoadFilter(
  _In_ PCUNICODE_STRING FilterName
);

Parameters

FilterName [in]

Pointer to a UNICODE_STRING structure containing the service name for the minifilter driver.

Return value

FltLoadFilter returns STATUS_SUCCESS or an appropriate NTSTATUS value, such as one of the following:

Return codeDescription
STATUS_DRIVER_FAILED_PRIOR_UNLOAD

The minifilter driver could not be loaded because a previous version of the driver is still in memory. This is an error code.

STATUS_FAILED_DRIVER_ENTRY

The minifilter driver's DriverEntry routine returned an NTSTATUS value that was not a success code. This is an error code.

STATUS_IMAGE_ALREADY_LOADED

The minifilter driver is already running. This is an error code.

STATUS_OBJECT_NAME_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 load that minifilter driver by calling FltLoadFilter.

To unload the supporting minifilter driver, call FltUnloadFilter.

Requirements

Target platform

Universal

Header

Fltkernel.h (include Fltkernel.h)

Library

FltMgr.lib

DLL

Fltmgr.sys

IRQL

PASSIVE_LEVEL

See also

FltUnloadFilter
UNICODE_STRING

 

 

Send comments about this topic to Microsoft

Show: