Export (0) Print
Expand All
Expand Minimize

FltReleaseContextsEx routine

FltReleaseContextsEx releases each context in a given FLT_RELATED_CONTEXTS_EX structure.

Syntax


VOID FltReleaseContextsEx(
  _In_  SIZE_T ContextsSize,
  _In_  PFLT_RELATED_CONTEXTS Contexts
);

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

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.

Requirements

Version

Available starting with Windows 8.

Header

Fltkernel.h (include Fltkernel.h)

Library

FltMgr.lib

IRQL

See Remarks section.

See also

FLT_CONTEXT_REGISTRATION
FLT_RELATED_CONTEXTS_EX
FltAllocateContext
FltGetContextsEx
FltReleaseContext

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft