structure FLT_RELATED_CONTEXTS_EX (fltkernel.h)
La structure FLT_RELATED_CONTEXTS_EX contient les contextes d’un pilote minifilter 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 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
Pointeur opaque vers le contexte par fichier du pilote minifilter pour le handle de flux vers lequel pointe FileObject membre de la structure FLT_RELATED_OBJECTS.
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
Pointeur opaque vers le contexte de transaction du minifilter pour la transaction vers laquelle pointe transaction membre de la structure FLT_RELATED_OBJECTS.
SectionContext
Pointeur opaque vers le contexte de section du minifilter pour le handle de flux vers lequel pointe FileObject membre de la structure FLT_RELATED_OBJECTS.
Remarques
La structure FLT_RELATED_CONTEXTS_EX 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_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 pour FltGetContextsEx.
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_EX comme paramètre Contexts pour FltReleaseContextsEx.
Pour plus d’informations sur l’utilisation de contextes, consultez l’entrée de référence pour FltAllocateContext.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows 8. |
| d’en-tête | fltkernel.h (include Fltkernel.h) |