Macro FsRtlGetPerStreamContextPointer (ntifs.h)

Article
02/07/2025

La macro FsRtlGetPerStreamContextPointer retourne le contexte de flux du système de fichiers pour un flux de fichiers.

Syntaxe

void FsRtlGetPerStreamContextPointer(
   _fo
);

Paramètres

_fo

Pointeur vers un objet de fichier pour le flux de fichiers.

Valeur de retour

Aucun

Remarques

Les pilotes de filtre du système de fichiers peuvent utiliser la macro FsRtlGetPerStreamContextPointer pour obtenir un pointeur de contexte de flux pour le flux de fichiers représenté par un objet de fichier donné. Un pointeur de contexte de flux est un pointeur vers le contexte de flux du système de fichiers pour le flux de fichiers. Ce pointeur peut être passé en tant que paramètre à FsRtlInsertPerStreamContext, FsRtlLookupPerStreamContextet FsRtlRemovePerStreamContext.

Le pointeur de contexte de flux pointe vers une structure FSRTL_ADVANCED_FCB_HEADER qui identifie de façon unique le flux de fichiers vers le système de fichiers. Cette structure est généralement incorporée dans un objet de contexte de flux, tel qu’un bloc de contrôle de fichier (FCB) ou un bloc de contrôle de flux (SCB). Lorsque le flux de fichiers est ouvert, le système de fichiers stocke un pointeur vers le FCB ou SCB dans le membre FsContext de l’objet de fichier.

Remarque La macro FsRtlGetPerStreamContextPointer ne peut être utilisée que sur les systèmes de fichiers qui prennent en charge les en-têtes FCB avancés.

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	Windows XP ; Correctif cumulatif windows 2000 SP4
plateforme cible	Bureau
d’en-tête	ntifs.h (include Ntifs.h)
IRQL	<= APC_LEVEL