FltGetInstanceContext function

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

NTSTATUS FLTAPI FltGetInstanceContext(
  PFLT_INSTANCE Instance,
  PFLT_CONTEXT  *Context
);

Parameters

Instance

Opaque instance pointer for the instance.

Context

Pointer to a caller-allocated variable that receives the address of the instance context.

Return value

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

Remarks

FltGetInstanceContext retrieves a context that was set for an instance by a given minifilter driver.

FltGetInstanceContext increments the reference count on the context that the Context parameter points to. When this context pointer is no longer needed, the caller must decrement its reference count by calling FltReleaseContext. Thus every successful call to FltGetInstanceContext must be matched by a subsequent call to FltReleaseContext.

To set a context for an instance, call FltSetInstanceContext.

To allocate a new context, call FltAllocateContext.

To delete an instance context, call FltDeleteInstanceContext or FltDeleteContext.

Requirements