FsRtlLookupPerFileContext, fonction (ntifs.h)
La routine FsRtlLookupPerFileContext retourne un pointeur vers un objet FSRTL_PER_FILE_CONTEXT associé à un fichier spécifié.
Syntaxe
PFSRTL_PER_FILE_CONTEXT FsRtlLookupPerFileContext(
[in] PVOID *PerFileContextPointer,
[in, optional] PVOID OwnerId,
[in, optional] PVOID InstanceId
);
Paramètres
[in] PerFileContextPointer
Pointeur vers un pointeur opaque utilisé par le package FSRTL (File System Runtime Library) pour suivre les contextes de fichier. 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 le 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 nonNULL si InstanceId n’est pasNULL.
[in, optional] InstanceId
Pointeur vers une variable allouée par le pilote de filtre qui peut être utilisée 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.
Valeur de retour
Pointeur vers la première structure de FSRTL_PER_FILE_CONTEXT qui correspond au OwnerId
Remarques
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.
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
Per-File contexte de suivi dans un pilote de filtre de système de fichiers hérité