FsRtlSetupAdvancedHeader-Funktion (ntifs.h)

Artikel
12/21/2024

Das FsRtlSetupAdvancedHeader Makros 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 zu initialisierende FSRTL_ADVANCED_FCB_HEADER Struktur.

FMutex

Ein Zeiger auf einen initialisierten schnellen Mutex, der verwendet wird, um den Zugriff auf die FSRTL_ADVANCED_FCB_HEADER Struktur zu synchronisieren. Der schnelle Mutex muss aus einem nicht seitengebundenen Pool zugewiesen 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 FastMutex-NULL-ist, muss der Aufrufer explizit das FastMutex Member des Streamkontextobjekts festlegen, um auf den vorhandenen schnellen Mutex zu verweisen. (Dies kann vor oder nach dem Aufrufen FsRtlSetupAdvancedHeadererfolgen.)

Rückgabewert

Nichts

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 Kontextstrukturen pro Stream freizugeben.

Weitere Informationen finden Sie unter Tracking Per-Stream Context in einem Legacy File System Filter Driver.