Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
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

Target platform

Universal

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:
© 2015 Microsoft