structure FLT_RELATED_CONTEXTS_EX (fltkernel.h)

Article
08/07/2023

La structure FLT_RELATED_CONTEXTS_EX contient les contextes d’un pilote de minifiltre pour les objets associés à une opération d’E/S. Cette structure étend la structure FLT_RELATED_CONTEXTS pour inclure le contexte de section.

Syntaxe

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;

Membres

VolumeContext

Pointeur opaque vers le contexte du minifiltre pour le volume vers lequel pointe le membre Volume de la structure FLT_RELATED_OBJECTS .

InstanceContext

Pointeur opaque vers le contexte du pilote minifiltre pour le instance vers lequel pointe le membre d’instance de la structure FLT_RELATED_OBJECTS.

FileContext

Pointeur opaque vers le contexte par fichier du pilote minifiltre pour le handle de flux vers lequel pointe le membre FileObject de la structure FLT_RELATED_OBJECTS .

StreamContext

Pointeur opaque vers le contexte de flux du minifiltre pour le handle de flux vers lequel pointe le membre FileObject de la structure FLT_RELATED_OBJECTS .

StreamHandleContext

Pointeur opaque vers le contexte de handle de flux du minifiltre pour le handle de flux vers lequel pointe le membre FileObject de la structure FLT_RELATED_OBJECTS .

TransactionContext

Pointeur opaque vers le contexte de transaction du minifiltre pour la transaction vers laquelle pointe le membre Transaction de la structure FLT_RELATED_OBJECTS .

SectionContext

Pointeur opaque vers le contexte de section du minifiltre pour le handle de flux vers lequel pointe le membre FileObject de la structure FLT_RELATED_OBJECTS .

Remarques

La structure FLT_RELATED_CONTEXTS_EX contient les contextes d’un pilote de minifiltre pour les objets associés à une opération d’E/S ou à une opération de configuration ou de démontage de instance.

Un pilote de minifiltre utilise la structure FLT_RELATED_CONTEXTS_EX pour récupérer plusieurs contextes pour une opération donnée. Pour ce faire, le pilote minifilter alloue une structure de FLT_RELATED_CONTEXTS_EX vide et lui transmet un pointeur en tant que paramètre Contexts vers FltGetContextsEx.

Un minifiltre peut également utiliser cette structure pour libérer plusieurs contextes pour une opération donnée. Pour ce faire, le pilote minifilter passe un pointeur vers FLT_RELATED_CONTEXTS_EX comme paramètre Contexts vers FltReleaseContextsEx.

Pour plus d’informations sur l’utilisation de contextes, consultez l’entrée de référence pour FltAllocateContext.