FltStartFiltering function (fltkernel.h)

FltStartFiltering starts filtering for a registered minifilter driver.

Syntax

NTSTATUS FLTAPI FltStartFiltering(
  [in] PFLT_FILTER Filter
);

Parameters

[in] Filter

Opaque filter pointer returned by FltRegisterFilter.

Return value

FltStartFiltering returns STATUS_SUCCESS or an appropriate NTSTATUS value such as the following:

Return code Description
STATUS_INVALID_PARAMETER
Filtering was already started for this minifilter driver. This is an error code.

Remarks

A minifilter driver typically calls FltStartFiltering from its DriverEntry routine after it has completed its global initialization and called FltRegisterFilter. FltStartFiltering notifies the Filter Manager that the minifilter driver is ready to begin attaching to volumes and filtering I/O requests. After the minifilter driver calls this routine, the Filter Manager treats the minifilter driver as a fully active minifilter driver, presenting it with volumes to attach to, as well as I/O requests. The minifilter driver must be prepared to begin receiving these notifications and I/O requests even before FltStartFiltering returns.

Requirements

Requirement Value
Target Platform Universal
Header fltkernel.h (include Fltkernel.h)
Library FltMgr.lib
DLL Fltmgr.sys
IRQL <= APC_LEVEL

See also

FltRegisterFilter