FltReleaseContextsEx - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// fltkernel.h

VOID FLTAPI FltReleaseContextsEx(
  [in] SIZE_T                   ContextsSize,
  [in] PFLT_RELATED_CONTEXTS_EX Contexts
);

View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (nf-fltkernel-fltreleasecontextsex)

FltReleaseContextsEx function

Description

FltReleaseContextsEx releases each context in a given FLT_RELATED_CONTEXTS_EX structure.

Parameters

ContextsSize [in]

The size, in bytes, of the FLT_RELATED_CONTEXTS_EX structure pointed to by Contexts. Set to sizeof(FLT_RELATED_CONTEXTS_EX).

Contexts [in]

Pointer to the FLT_RELATED_CONTEXTS_EX structure.

Return value

None

Remarks

For more information about contexts, see About minifilter contexts.

FltReleaseContextsEx decrements the reference count on all contexts in the FLT_RELATED_CONTEXTS_EX structure and sets all members of the structure to NULL_CONTEXT.

To get the FLT_RELATED_CONTEXTS_EX structure for a given minifilter driver for a given I/O request, call FltGetContextsEx.

For more information about context reference counting, see Referencing Contexts.

Callers of FltReleaseContextsEx must be running at IRQL <= DISPATCH_LEVEL if all contexts were allocated from nonpaged pool. If any contexts were allocated from paged pool, callers must be running at IRQL <= APC_LEVEL.

When each context's reference count reaches zero, the context is freed immediately if the caller is running at IRQL <= APC_LEVEL. If the caller is running at IRQL DISPATCH_LEVEL, a work item is scheduled to free the context.

See also

FLT_CONTEXT_REGISTRATION

FLT_RELATED_CONTEXTS_EX

FltAllocateContext

FltGetContextsEx

FltReleaseContext