Fonction FsRtlLookupPerFileObjectContext (ntifs.h)

Article
02/26/2024

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 .

Note Les pilotes de minifiltre du système de fichiers ne doivent pas utiliser les fonctions FsRtlXxxPerFileObjectContext . Au lieu de cela, les minifiltres peuvent utiliser les fonctions de contexteFltXxx pour associer des informations de contexte à un objet de fichier. Pour obtenir la liste complète, consultez la rubrique FSRTL_PER_FILEOBJECT_CONTEXT .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Plateforme cible	Universal
En-tête	ntifs.h (inclure Fltkernel.h, Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Voir aussi

FSRTL_PER_FILEOBJECT_CONTEXT

FsRtlInitPerFileObjectContext

FsRtlInsertPerFileObjectContext

FsRtlRemovePerFileObjectContext

Partager via