FsRtlInsertPerFileObjectContext, fonction (ntifs.h)

Article
12/21/2024

Pour un pilote de filtre de système de fichiers « hérité », la fonction FsRtlInsertPerFileObjectContext associe des informations de contexte à un objet de fichier.

Syntaxe

NTSTATUS FsRtlInsertPerFileObjectContext(
  [in] PFILE_OBJECT                  FileObject,
  [in] PFSRTL_PER_FILEOBJECT_CONTEXT Ptr
);

Paramètres

[in] FileObject

Pointeur vers l’objet de fichier pour lequel associer des informations de contexte (données par le paramètre Ptr).

[in] Ptr

Pointeur vers une structure d’FSRTL_PER_FILEOBJECT_CONTEXT allouée par l’appelant et initialisée à associer à FileObject. La structure peut être utilisée as-is ou incorporée dans une structure d’informations de contexte de contexte par fichier définie par fichier. Pour initialiser la structure, utilisez la macro FsRtlInitPerFileObjectContext.

Valeur de retour

FsRtlInsertPerFileObjectContext retourne une valeur NTSTATUS appropriée, telle que l’une des suivantes :

Retourner le code	Description
STATUS_SUCCESS	La structure d’informations de contexte a été correctement associée à l’objet fichier.
STATUS_INVALID_PARAMETER	Le paramètre FileObject est NULL.
STATUS_INSUFFICIENT_RESOURCES	Le système ne dispose pas des ressources suffisantes pour terminer l’opération. Par exemple, une extension d’objet de fichier n’a pas pu être allouée pour FileObject.

Remarques

Un pilote de filtre de système de fichiers appelle FsRtlInsertPerFileObjectContext associer sa propre structure de contexte par fichier à un objet de fichier. La structure de contexte contient des informations de contexte que le pilote de filtre conserve pour l’objet de fichier. La fonction FsRtlInsertPerStreamContext insère la structure de contexte Ptr dans la liste de contextes de FileObject.

Toutes les structures d’informations de contexte par fichier doivent être ou contenir une structure de FSRTL_PER_FILEOBJECT_CONTEXT initialisée. Utilisez la macro FsRtlInitPerFileObjectContext pour initialiser une structure FSRTL_PER_FILEOBJECT_CONTEXT.

Une fois qu’une structure FSRTL_PER_FILEOBJECT_CONTEXT ou une structure de contexte d’objet de filtre définie par fichier (contenant une structure d’FSRTL_PER_FILEOBJECT_CONTEXT initialisée) a été associée à un objet de fichier, elle peut être récupérée en appelant FsRtlLookupPerFileObjectContext ou supprimée en appelant FsRtlRemovePerFileObjectContext.

Remarque les pilotes minifilter du système de fichiers ne doivent pas utiliser les fonctions FsRtlXxxPerFileObjectContext. Au lieu de cela, les mini-filtres peuvent utiliser les fonctions FltXxxContext pour associer des informations de contexte à un objet de fichier. Pour obtenir une liste complète, consultez la rubrique FSRTL_PER_FILEOBJECT_CONTEXT.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista
plateforme cible	Universel
d’en-tête	ntifs.h (include Fltkernel.h, Ntifs.h)
bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Voir aussi

FSRTL_PER_FILEOBJECT_CONTEXT

FsRtlInitPerFileObjectContext

FsRtlLookupPerFileObjectContext

FsRtlRemovePerFileObjectContext

Partager via