structure FLT_RELATED_CONTEXTS_EX (fltkernel.h)
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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible à partir de Windows 8. |
| En-tête | fltkernel.h (inclure Fltkernel.h) |