FsRtlSetupAdvancedHeader, fonction (ntifs.h)

Article
12/21/2024

La macro FsRtlSetupAdvancedHeader est utilisée par les systèmes de fichiers pour initialiser une structure FSRTL_ADVANCED_FCB_HEADER à utiliser avec des contextes de filtre.

Syntaxe

void FsRtlSetupAdvancedHeader(
  PVOID       AdvHdr,
  PFAST_MUTEX FMutex
);

Paramètres

AdvHdr

Pointeur vers la structure FSRTL_ADVANCED_FCB_HEADER à initialiser.

FMutex

Pointeur vers un mutex rapide initialisé qui sera utilisé pour synchroniser l’accès à la structure FSRTL_ADVANCED_FCB_HEADER. Le mutex rapide doit être alloué à partir du pool non paginé.

Ce paramètre peut être NULL. Les appelants doivent définir ce paramètre sur NULL s’ils ont l’intention d’utiliser un objet mutex rapide déjà existant. Si FastMutex est NULL, l’appelant doit définir explicitement le membre FastMutex de l’objet de contexte de flux pour pointer vers le mutex rapide existant. (Cette opération peut être effectuée avant ou après l’appel de FsRtlSetupAdvancedHeader.)

Valeur de retour

Aucun

Remarques

Les systèmes de fichiers utilisent la macro FsRtlSetupAdvancedHeader pour initialiser une structure FSRTL_ADVANCED_FCB_HEADER à utiliser avec des contextes de filtre.

Lorsque la structure d’en-tête FCB avancée n’est plus nécessaire, le système de fichiers doit appeler FsRtlTeardownPerStreamContexts pour libérer toutes les structures de contexte par flux associées.

Pour plus d’informations, consultez suivi Per-Stream contexte dans un pilote de filtre de système de fichiers hérité.