Partager via


Fonction FsRtlInsertPerStreamContext (ntifs.h)

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

Voir aussi

FSRTL_ADVANCED_FCB_HEADER

FSRTL_PER_STREAM_CONTEXT

FsRtlGetPerStreamContextPointer

FsRtlInitPerStreamContext

FsRtlLookupPerStreamContext

FsRtlRemovePerStreamContext

FsRtlSetupAdvancedHeader

FsRtlSupportsPerStreamContexts

FsRtlTeardownPerStreamContexts