structure FLT_RELATED_CONTEXTS (fltkernel.h)

La structure FLT_RELATED_CONTEXTS contient les contextes d’un pilote minifilter 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 minifilter pour le volume vers lequel pointe le volume membre de la structure FLT_RELATED_OBJECTS.

InstanceContext

Pointeur opaque vers le contexte du pilote minifilter pour l’instance vers laquelle pointe instance membre 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 minifilter pour le handle de flux vers lequel pointe le FileObject membre 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 minifilter 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 minifilter pour le handle de flux vers lequel le FileObject membre de la structure FLT_RELATED_OBJECTS pointe vers.

TransactionContext

Sur Windows Vista et versions ultérieures, ce membre est un pointeur opaque vers le contexte de transaction du minifilter pour la transaction vers laquelle la transaction transaction membre de la structure FLT_RELATED_OBJECTS pointe vers. 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 minifilter pour les objets associés à une opération d’E/S ou à une opération d’installation ou de suppression d’instance.

Un pilote minifilter 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 minifilter 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 en tant que paramètre Contexts pour FltReleaseContexts.

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

Exigences

Voir aussi

FLT_CONTEXT_REGISTRATION

FLT_RELATED_OBJECTS

FltAllocateContext

FltGetContexts

FltReleaseContexts