FltRegisterFilter function

Download EaseFilter Filter Driver SDK Setup File
Download EaseFilter Filter Driver SDK Zip File

NTSTATUS FLTAPI FltRegisterFilter(
  PDRIVER_OBJECT         Driver,
  const FLT_REGISTRATION *Registration,
  PFLT_FILTER            *RetFilter
);

Parameters

Driver

A pointer to the driver object for the minifilter driver. This should be the same driver object pointer that was passed as input to the minifilter driver's DriverEntry routine.

Registration

A pointer to a caller-allocated minifilter driver registration structure (FLT_REGISTRATION).

RetFilter

A pointer to a caller-allocated variable that receives an opaque filter pointer for the caller.

Return value

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

Remarks

Every minifilter driver must call FltRegisterFilter from its DriverEntry routine to add itself to the global list of registered minifilter drivers and to provide the Filter Manager with a list of callback functions and other information about the minifilter driver.

FltRegisterFilter returns an opaque filter pointer for the minifilter driver in *RetFilter. This pointer value uniquely identifies the minifilter driver and remains constant as long as the minifilter driver is loaded. The minifilter driver should save this pointer, because it is a required parameter for FltStartFiltering and FltUnregisterFilter.

After calling FltRegisterFilter, a minifilter driver typically calls FltStartFiltering to begin filtering I/O operations.

A minifilter driver can only call FltRegisterFilter to register itself, not another minifilter driver.

To unregister itself, a minifilter driver calls FltUnregisterFilter..

Requirements