FltGetSectionContext, fonction (fltkernel.h)
La routine FltGetSectionContext récupère un contexte de section créé pour un flux de fichiers par une instance de pilote minifilter spécifiée.
Syntaxe
NTSTATUS FLTAPI FltGetSectionContext(
[in] PFLT_INSTANCE Instance,
[in] PFILE_OBJECT FileObject,
[out] PFLT_CONTEXT *Context
);
Paramètres
[in] Instance
Pointeur d’instance opaque pour l’instance de pilote minifilter dont le contexte doit être récupéré.
[in] FileObject
Pointeur vers un objet de 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 de retour
FltGetSectionContext retourne STATUS_SUCCESS lorsqu’elle retourne correctement le contexte de section demandé. Sinon, elle retourne une valeur NTSTATUS appropriée, telle que l’une des suivantes :
| Retourner le code | Description |
|---|---|
| STATUS_NOT_FOUND | Aucun contexte correspondant n’a été trouvé sur ce fichier pour l’instant. Par conséquent, FltMgr définir contexte 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 minifilter.
FltGetSectionContext récupère un contexte de section créé pour un flux de fichiers par une instance de pilote minifilter spécifiée. Un contexte de section est créé en appelant FltCreateSectionForDataScan.
FltGetSectionContext incrémente le nombre de références sur le 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 minifilters ne doivent pas supprimer explicitement un contexte de section passé à FltCreateSectionForDataScan. Un contexte de section est désalloué et supprimé d’un flux en appelant FltCloseSectionForDataScan dans ce cas.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 8 |
| plateforme cible | Universel |
| d’en-tête | fltkernel.h (include Fltkernel.h) |
| bibliothèque | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |