FsRtlSetupAdvancedHeaderEx-Makro (ntifs.h)

Artikel
12/22/2024

Das FsRtlSetupAdvancedHeaderEx Makros wird von Dateisystemen verwendet, um eine FSRTL_ADVANCED_FCB_HEADER Struktur für die Verwendung mit Stream- und Dateikontexten zu initialisieren.

Syntax

void FsRtlSetupAdvancedHeaderEx(
   _advhdr,
   _fmutx,
   _fctxptr
);

Parameter

_advhdr

Zeiger auf die zu initialisierende FSRTL_ADVANCED_FCB_HEADER Struktur.

_fmutx

Zeiger auf einen initialisierten schnellen Mutex, der verwendet wird, um den Zugriff auf bestimmte FSRTL_ADVANCED_FCB_HEADER Mitglieder zu synchronisieren. Der schnelle Mutex muss aus einem nicht seitengebundenen Pool zugewiesen werden. Dieser Parameter ist optional und kann NULL-werden. 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-Element der FSRTL_ADVANCED_FCB_HEADER Struktur festlegen, das im Streamkontextobjekt enthalten ist, um auf den vorhandenen schnellen Mutex zu verweisen. (Dies kann vor oder nach dem Aufrufen von FsRtlSetupAdvancedHeaderExerfolgen.)

_fctxptr

Ein Zeiger auf ein Zeigerfeld, das von der Dateisystemlaufzeitbibliothek (FSRTL) zum Nachverfolgen von Dateikontexten verwendet wird. Dieser Parameter ist optional und kann NULL-werden. Besonders:

Für Microsoft Windows-Betriebssysteme, die vor Windows Vista veröffentlicht wurden, müssen Aufrufer diesen Parameter auf NULL-festlegen.
Für Windows-Betriebssysteme ab Windows Vista: Wenn FileContextSupportPointer nicht NULL-ist, muss FileContextSupportPointer- ein Zeiger auf eine PVOID-Variable innerhalb einer Dateistruktur für das Dateisystem sein, das die Struktur erstellt hat. Um anzugeben, dass der Dateisystemtreiber Dateikontexte nicht unterstützt, müssen Aufrufer FileContextSupportPointer- auf NULL-festlegen.

Rückgabewert

Nichts

Bemerkungen

Dateisysteme verwenden das FsRtlSetupAdvancedHeaderEx- Makro, um eine FSRTL_ADVANCED_FCB_HEADER Struktur für die Verwendung mit Datenstrom- und Dateikontexten zu initialisieren.

Wenn die erweiterte FCB-Headerstruktur nicht mehr erforderlich ist, muss das Dateisystem FsRtlTeardownPerStreamContexts aufrufen, um alle zugeordneten Datenstrom- und Dateikontextstrukturen freizugeben.

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

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Updaterollup für Microsoft Windows 2000 Service Pack 4 (SP4); Windows XP
Zielplattform-	Desktop
Header-	ntifs.h (einschließlich Ntifs.h, Fltkernel.h)
IRQL-	PASSIVE_LEVEL