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 |
|---|---|
|
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 |