Fonction FsRtlLookupPerFileContext (ntifs.h)
La routine FsRtlLookupPerFileContext retourne un pointeur vers un objet FSRTL_PER_FILE_CONTEXT associé à un fichier spécifié.
PFSRTL_PER_FILE_CONTEXT FsRtlLookupPerFileContext(
[in] PVOID *PerFileContextPointer,
[in, optional] PVOID OwnerId,
[in, optional] PVOID InstanceId
);
[in] PerFileContextPointer
Pointeur vers un pointeur opaque utilisé par le package FSRTL (File System Runtime Library) pour suivre les contextes de fichiers. Pour récupérer ce pointeur à partir d’un objet de fichier, utilisez la macro FsRtlGetPerFileContextPointer .
[in, optional] OwnerId
Pointeur vers une variable allouée par un pilote de filtre qui identifie de manière unique le propriétaire de la structure de contexte par fichier. Le format de cette variable est spécifique au pilote de filtre. Ce paramètre est facultatif, mais doit être non NULL si InstanceId n’est pas NULL.
[in, optional] InstanceId
Pointeur vers une variable allouée par un pilote de filtre qui peut être utilisé pour distinguer les structures de contexte par 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.
Pointeur vers la première structure FSRTL_PER_FILE_CONTEXT qui correspond à OwnerId et InstanceId, si spécifié, ou NULL si aucune correspondance n’est trouvée ou le système de fichiers ne prend pas en charge les contextes par fichier.
En ne spécifiant pas OwnerID et InstanceId, un pilote de filtre peut rechercher le premier contexte associé à un fichier.
Si le système de fichiers ne prend pas en charge les objets de contexte par fichier, null est retourné. Utilisez la macro FsRtlSupportsPerFileContexts pour déterminer si un système de fichiers prend en charge les objets de contexte par fichier.
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Plateforme cible | Universal |
| En-tête | ntifs.h (include FltKernel.h, Ntifs.h) |
| Bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |
Suivi Per-File contexte dans un pilote de filtre de système de fichiers hérité