Fonction FsRtlLookupPerFileObjectContext (ntifs.h)

Pour un pilote de filtre de système de fichiers « hérité », la fonction FsRtlLookupPerFileObjectContext récupère les informations de contexte précédemment associées à un objet de fichier.

Syntaxe

PFSRTL_PER_FILEOBJECT_CONTEXT FsRtlLookupPerFileObjectContext(
  [in]           PFILE_OBJECT FileObject,
  [in, optional] PVOID        OwnerId,
  [in, optional] PVOID        InstanceId
);

Paramètres

[in] FileObject

Pointeur vers un objet de fichier pour lequel interroger des informations de contexte.

[in, optional] OwnerId

Pointeur vers une variable allouée par l’appelant qui identifie de manière unique le filtre propriétaire de la structure de contexte par fichier-objet. Le format de cette variable est spécifique au pilote de filtre.

[in, optional] InstanceId

Pointeur vers une variable allouée par l’appelant qui peut être utilisé pour distinguer les structures de contexte par objet de fichier créées par le même pilote de filtre. Le format de cette variable est spécifique au pilote de filtre. Ce paramètre est facultatif et peut être NULL.

Valeur retournée

FsRtlLookupPerFileObjectContext retourne un pointeur vers le premier contexte correspondant par fichier-objet trouvé. Si aucune correspondance n’est trouvée, FsRtlLookupPerFileObjectContext retourne NULL.

Remarques

Un pilote de filtre de système de fichiers « hérité » appelle FsRtlLookupPerFileObjectContext pour récupérer sa structure de contexte par objet de fichier pour un objet de fichier. La structure de contexte contient des informations de contexte que le pilote de filtre conserve pour l’objet de fichier. Cette structure de contexte doit avoir déjà été associée à l’objet file en appelant la fonction FsRtlInsertPerFileObjectContext .

Si la structure FSRTL_PER_FILEOBJECT_CONTEXT est incorporée dans une structure de contexte de filtre définie par objet de fichier, la macro CONTAINING_RECORD peut être utilisée pour obtenir un pointeur vers la tête de la structure définie par filtre.

Pour initialiser une structure de contexte par objet de fichier, utilisez la macro FsRtlInitPerFileObjectContext .

Pour associer une structure de contexte par fichier-objet initialisée à un objet fichier, utilisez la fonction FsRtlInsertPerFileObjectContext .

Pour supprimer une structure de contexte par fichier-objet associée à un objet fichier, utilisez la fonction FsRtlRemovePerFileObjectContext .

Configuration requise

Voir aussi

FSRTL_PER_FILEOBJECT_CONTEXT

FsRtlInitPerFileObjectContext

FsRtlInsertPerFileObjectContext

FsRtlRemovePerFileObjectContext