FLT_RELATED_CONTEXTS_EX structure (fltkernel.h)

The FLT_RELATED_CONTEXTS_EX structure contains a minifilter driver's contexts for the objects associated with an I/O operation. This structure extends the FLT_RELATED_CONTEXTS structure to include the section context.

Syntax

typedef struct _FLT_RELATED_CONTEXTS_EX {
  PFLT_CONTEXT VolumeContext;
  PFLT_CONTEXT InstanceContext;
  PFLT_CONTEXT FileContext;
  PFLT_CONTEXT StreamContext;
  PFLT_CONTEXT StreamHandleContext;
  PFLT_CONTEXT TransactionContext;
  PFLT_CONTEXT SectionContext;
} FLT_RELATED_CONTEXTS_EX, *PFLT_RELATED_CONTEXTS_EX;

Members

VolumeContext

Opaque pointer to the minifilter's context for the volume that the Volume member of the FLT_RELATED_OBJECTS structure points to.

InstanceContext

Opaque pointer to the minifilter driver's context for the instance that the Instance member of the FLT_RELATED_OBJECTS structure points to.

FileContext

An opaque pointer to the minifilter driver's per-file context for the stream handle that the FileObject member of the FLT_RELATED_OBJECTS structure points to.

StreamContext

Opaque pointer to the minifilter's stream context for the stream handle that the FileObject member of the FLT_RELATED_OBJECTS structure points to.

StreamHandleContext

Opaque pointer to the minifilter's stream handle context for the stream handle that the FileObject member of the FLT_RELATED_OBJECTS structure points to.

TransactionContext

An opaque pointer to the minifilter's transaction context for the transaction that the Transaction member of the FLT_RELATED_OBJECTS structure points to.

SectionContext

An opaque pointer to the minifilter's section context for the stream handle that the FileObject member of the FLT_RELATED_OBJECTS structure points to.

Remarks

The FLT_RELATED_CONTEXTS_EX structure contains a minifilter driver's contexts for the objects associated with an I/O operation or an instance setup or teardown operation.

A minifilter driver uses the FLT_RELATED_CONTEXTS_EX structure to retrieve multiple contexts for a given operation. To do so, the minifilter driver allocates an empty FLT_RELATED_CONTEXTS_EX structure and passes a pointer to it as the Contexts parameter to FltGetContextsEx.

A minifilter can also use this structure to release multiple contexts for a given operation. To do so, the minifilter driver passes a pointer to FLT_RELATED_CONTEXTS_EX as the Contexts parameter to FltReleaseContextsEx.

For more information about using contexts, see the reference entry for FltAllocateContext.

Requirements

Requirement Value
Minimum supported client Available starting with Windows 8.
Header fltkernel.h (include Fltkernel.h)

See also

FLT_CONTEXT_REGISTRATION

FLT_RELATED_OBJECTS

FltAllocateContext

FltGetContextsEx

FltReleaseContextsEx