FsRtlInsertPerStreamContext, fonction (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 du 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 de retour
FsRtlInsertPerStreamContext retourne l’une des valeurs NTSTATUS suivantes :
| Retourner le code | Description |
|---|---|
|
L’appel à FsRtlInsertPerStreamContext a réussi. |
|
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 gère 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é.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Correctif cumulatif windows 2000 SP4 ; Windows XP |
| plateforme cible | Universel |
| d’en-tête | ntifs.h (include Ntifs.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |
Voir aussi
FsRtlGetPerStreamContextPointer