Edit

FltObjectReference function (fltkernel.h)

  • Article

The FltObjectReference routine adds a rundown reference to an opaque filter, instance, or volume pointer.

Syntax

NTSTATUS FLTAPI FltObjectReference(
  [in, out] PVOID FltObject
);

Parameters

[in, out] FltObject

Opaque filter pointer (PFLT_FILTER), instance pointer (PFLT_INSTANCE), or volume pointer (PFLT_VOLUME).

Return value

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

Return code Description
STATUS_FLT_DELETING_OBJECT
 The minifilter driver, instance, or volume is being torn down. This is an error code.

Remarks

Adding a rundown reference to an opaque filter, instance, or volume object pointer prevents the object from being freed.

To remove a rundown reference from an opaque filter, instance, or volume pointer, call FltObjectDereference.

Requirements

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

See also

FltObjectDereference