Fonction FltGetSectionContext (fltkernel.h)

La routine FltGetSectionContext récupère un contexte de section créé pour un flux de fichiers par un pilote minifilter spécifié instance.

Syntaxe

NTSTATUS FLTAPI FltGetSectionContext(
  [in]  PFLT_INSTANCE Instance,
  [in]  PFILE_OBJECT  FileObject,
  [out] PFLT_CONTEXT  *Context
);

Paramètres

[in] Instance

Pointeur de instance opaque pour le pilote minifilter instance dont le contexte doit être récupéré.

[in] FileObject

Pointeur vers un objet fichier pour le flux.

[out] Context

Pointeur vers une variable allouée par l’appelant qui reçoit l’adresse du contexte. Ce paramètre est obligatoire et ne peut pas être défini sur NULL.

Valeur retournée

FltGetSectionContext retourne STATUS_SUCCESS lorsqu’il retourne correctement le contexte de section demandé. Sinon, elle retourne une valeur NTSTATUS appropriée, telle que l’une des valeurs suivantes :

Code de retour	Description
STATUS_NOT_FOUND	Aucun contexte correspondant n’a été trouvé sur ce fichier pour l’instant. Par conséquent, FltMgr a défini Context sur NULL_CONTEXT. Il s’agit d’un code d’erreur.
STATUS_NOT_SUPPORTED	Le volume attaché à cette instance ne prend pas en charge les contextes de section. Il s’agit d’un code d’erreur.

Remarques

Pour plus d’informations sur les contextes, consultez À propos des contextes de minifiltre.

FltGetSectionContext récupère un contexte de section créé pour un flux de fichiers par un pilote minifilter spécifié instance. Un contexte de section est créé en appelant FltCreateSectionForDataScan.

FltGetSectionContext incrémente le nombre de références en fonction du contexte vers lequel pointe le paramètre Context . Lorsque ce pointeur de contexte n’est plus nécessaire, l’appelant doit décrémenter son nombre de références en appelant FltReleaseContext. Ainsi, chaque appel réussi à FltGetSectionContext doit être mis en correspondance par un appel ultérieur à FltReleaseContext.

Pour allouer un nouveau contexte, appelez FltAllocateContext.

Les minifiltres ne doivent pas supprimer explicitement un contexte de section passé à FltCreateSectionForDataScan. Un contexte de section est libéré et supprimé d’un flux en appelant FltCloseSectionForDataScan dans ce cas.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8
Plateforme cible	Universal
En-tête	fltkernel.h (inclure Fltkernel.h)
Bibliothèque	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL

Voir aussi

FltAllocateContext

FltCloseSectionForDataScan

FltCreateSectionForDataScan

FltReleaseContext