FsRtlLookupPerFileObjectContext, fonction (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ée pour distinguer les structures de contexte par fichier-objet 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 de retour
FsRtlLookupPerFileObjectContext retourne un pointeur vers le premier contexte correspondant par objet-fichier 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-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 été précédemment associée à l’objet de fichier en appelant la fonction FsRtlInsertPerFileObjectContext.
Si la structure FSRTL_PER_FILEOBJECT_CONTEXT est incorporée dans une structure de contexte définie par objet par 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 fichier-objet, utilisez la macro FsRtlInitPerFileObjectContext .
Pour associer une structure de contexte par fichier-objet initialisée à un objet de fichier, utilisez la fonction FsRtlInsertPerFileObjectContext.
Pour supprimer une structure de contexte d’objet par fichier associée à un objet de fichier, utilisez la fonction FsRtlRemovePerFileObjectContext.
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 |