Macro FsRtlLookupPerStreamContext (ntifs.h)

Article
03/08/2023

La macro FsRtlLookupPerStreamContext récupère une structure de contexte par flux pour un flux de fichiers.

Syntaxe

void FsRtlLookupPerStreamContext(
   _sc,
   _oid,
   _iid
);

Paramètres

_sc

Pointeur vers la structure FSRTL_ADVANCED_FCB_HEADER pour le flux de fichiers. Pour obtenir ce pointeur à partir d’un objet fichier, utilisez la macro FsRtlGetPerStreamContextPointer .

_oid

Pointeur vers une variable allouée par l’appelant qui identifie de manière unique le propriétaire de la structure de contexte par flux. Le format de cette variable est le pilote de filtre - spécifique. Doit être non NULL si une valeur non NULL est fournie pour InstanceId.

_iid

Pointeur vers un pilote de filtre - variable allouée qui peut être utilisée pour distinguer les structures de contexte par flux créées par le même pilote de filtre. Le format de cette variable est le pilote de filtre - spécifique.

Si OwnerId et InstanceId sont tous deux NULL, FsRtlLookupPerStreamContext retourne le premier contexte par flux trouvé.

Si une valeur non NULL est fournie pour OwnerId et InstanceId est NULL, FsRtlLookupPerStreamContext retourne le premier contexte par flux trouvé dont le membre OwnerId correspond au paramètre OwnerId .

Valeur de retour

None

Remarques

Un pilote de filtre de système de fichiers appelle FsRtlLookupPerStreamContext pour récupérer sa structure de contexte par flux pour un flux de fichiers. La structure de contexte par flux contient des informations de contexte que le pilote de filtre gère pour le flux de fichiers.

RemarqueFsRtlLookupPerStreamContext ne peut être utilisé que sur les systèmes de fichiers qui prennent en charge les contextes par flux.

Pour initialiser une structure de contexte par flux, utilisez la macro FsRtlInitPerStreamContext .

Pour associer une structure de contexte par flux initialisée à un flux de fichiers, appelez FsRtlInsertPerStreamContext.

Pour supprimer une structure de contexte par flux associée à un flux de fichiers, appelez FsRtlRemovePerStreamContext.

Pour plus d’informations, consultez Suivi Per-Stream contexte dans un pilote de filtre de système de fichiers hérité.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Correctif cumulatif windows 2000 SP4 ; Windows XP
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	ntifs.h (include Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL