Fonction FsRtlInsertPerStreamContext (ntifs.h)

Article
02/29/2024

La routine FsRtlInsertPerStreamContext associe la structure de contexte par flux d’un pilote de filtre de système de fichiers à un flux de fichiers.

Syntaxe

NTSTATUS FsRtlInsertPerStreamContext(
       PFSRTL_ADVANCED_FCB_HEADER PerStreamContext,
  [in] PFSRTL_PER_STREAM_CONTEXT  Ptr
);

Paramètres

PerStreamContext

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

[in] Ptr

Pointeur vers une structure FSRTL_PER_STREAM_CONTEXT que le pilote de filtre a allouée et initialisée. Pour initialiser cette structure, utilisez la macro FsRtlInitPerStreamContext .

Valeur retournée

FsRtlInsertPerStreamContext retourne l’une des valeurs NTSTATUS suivantes :

Code de retour	Description
STATUS_SUCCESS	L’appel à FsRtlInsertPerStreamContext a réussi.
STATUS_INVALID_DEVICE_REQUEST	Le système de fichiers sous-jacent ne prend pas en charge les contextes de filtre.

Remarques

Un pilote de filtre de système de fichiers appelle FsRtlInsertPerStreamContext pour associer sa propre structure de contexte par flux à un flux de fichiers. La structure de contexte par flux contient des informations de contexte que le pilote de filtre conserve pour le flux de fichiers.

Une fois la structure de contexte par flux associée à un flux de fichiers, elle peut être récupérée en appelant FsRtlLookupPerStreamContext ou supprimée en appelant 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	Universal
En-tête	ntifs.h (inclure Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL