Fonction FsRtlSetupAdvancedHeader (ntifs.h)

Article
02/29/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 d’un 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 a la valeur NULL, l’appelant doit définir explicitement le membre FastMutex de l’objet de contexte de flux pour qu’il pointe vers le mutex rapide existant. (Cette opération peut être effectuée avant ou après l’appel de FsRtlSetupAdvancedHeader.)

Valeur de retour

None

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 requise, 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é.

Configuration requise

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