structure FLT_RELATED_CONTEXTS (fltkernel.h)

Article
08/07/2023

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

Syntaxe

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;

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

Sur Windows Vista et versions ultérieures, ce membre est un 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 . Sur les systèmes d’exploitation Windows antérieurs à Windows Vista, ce membre est réservé à l’utilisation du système.

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

Sur Windows Vista et versions ultérieures, ce membre est un pointeur opaque vers le contexte de transaction du minifiltre pour la transaction vers laquelle pointe le membre Transaction de la structure FLT_RELATED_OBJECTS . Sur les systèmes d’exploitation Windows antérieurs à Windows Vista, ce membre est réservé à l’utilisation du système.

Remarques

La structure FLT_RELATED_CONTEXTS 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 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 vide et lui transmet un pointeur en tant que paramètre Contexts à FltGetContexts.

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 comme paramètre Contexts vers FltReleaseContexts.

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