FltObjectReference function (fltkernel.h)

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