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 |