Macro FsRtlGetPerStreamContextPointer (ntifs.h)

Article
02/26/2024

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 fichier pour le flux de fichier.

Valeur de retour

None

Remarques

Les pilotes de filtre de 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 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, FsRtlLookupPerStreamContext et FsRtlRemovePerStreamContext.

Le pointeur de contexte de flux pointe vers une structure FSRTL_ADVANCED_FCB_HEADER qui identifie de manière unique le flux de fichiers dans 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.

Note 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é.

Configuration requise

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