Bewerken

Delen via


FLT_RELATED_CONTEXTS structure (fltkernel.h)

The FLT_RELATED_CONTEXTS structure contains a minifilter driver's contexts for the objects associated with an I/O operation.

Syntax

typedef struct _FLT_RELATED_CONTEXTS {
  PFLT_CONTEXT VolumeContext;
  PFLT_CONTEXT InstanceContext;
  PFLT_CONTEXT FileContext;
  PFLT_CONTEXT StreamContext;
  PFLT_CONTEXT StreamHandleContext;
  PFLT_CONTEXT TransactionContext;
} FLT_RELATED_CONTEXTS, *PFLT_RELATED_CONTEXTS;

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

On Windows Vista and later, this member is 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. On Windows operating systems earlier than Windows Vista, this member is reserved for system use.

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

On Windows Vista and later, this member is an opaque pointer to the minifilter's transaction context for the transaction that the Transaction member of the FLT_RELATED_OBJECTS structure points to. On Windows operating systems earlier than Windows Vista, this member is reserved for system use.

Remarks

The FLT_RELATED_CONTEXTS 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 structure to retrieve multiple contexts for a given operation. To do so, the minifilter driver allocates an empty FLT_RELATED_CONTEXTS structure and passes a pointer to it as the Contexts parameter to FltGetContexts.

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 as the Contexts parameter to FltReleaseContexts.

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

Requirements

Requirement Value
Header fltkernel.h (include Fltkernel.h)

See also

FLT_CONTEXT_REGISTRATION

FLT_RELATED_OBJECTS

FltAllocateContext

FltGetContexts

FltReleaseContexts