FsRtlSetupAdvancedHeader-Funktion (ntifs.h)

Artikel
02/26/2024

Das FsRtlSetupAdvancedHeader-Makro wird von Dateisystemen verwendet, um eine FSRTL_ADVANCED_FCB_HEADER-Struktur für die Verwendung mit Filterkontexten zu initialisieren.

Syntax

void FsRtlSetupAdvancedHeader(
  PVOID       AdvHdr,
  PFAST_MUTEX FMutex
);

Parameter

AdvHdr

Ein Zeiger auf die FSRTL_ADVANCED_FCB_HEADER Struktur, die initialisiert werden soll.

FMutex

Ein Zeiger auf einen initialisierten schnellen Mutex, der zum Synchronisieren des Zugriffs auf die FSRTL_ADVANCED_FCB_HEADER-Struktur verwendet wird. Der schnelle Mutex muss aus einem nicht ausgestellten Pool zugeordnet werden.

Dieser Parameter kann NULL sein. Aufrufer sollten diesen Parameter auf NULL festlegen, wenn sie ein bereits vorhandenes schnelles Mutex-Objekt verwenden möchten. Wenn FastMutexNULL ist, muss der Aufrufer das FastMutex-Element des Streamkontextobjekts explizit so festlegen, dass er auf den vorhandenen schnellen Mutex verweist. (Dies kann vor oder nach dem Aufruf von FsRtlSetupAdvancedHeader erfolgen.)

Rückgabewert

Keine

Bemerkungen

Dateisysteme verwenden das FsRtlSetupAdvancedHeader-Makro , um eine FSRTL_ADVANCED_FCB_HEADER-Struktur für die Verwendung mit Filterkontexten zu initialisieren.

Wenn die erweiterte FCB-Headerstruktur nicht mehr erforderlich ist, muss das Dateisystem FsRtlTeardownPerStreamContexts aufrufen, um alle zugeordneten pro Stream zugeordneten Kontextstrukturen frei zu geben.

Weitere Informationen finden Sie unter Nachverfolgen Per-Stream Kontexts in einem Legacy-Dateisystemfiltertreiber.