FsRtlInsertPerStreamContext-Funktion (ntifs.h)
Die FsRtlInsertPerStreamContext-Routine ordnet die Kontextstruktur eines Dateisystemfiltertreibers pro Stream einem Dateistream zu.
Syntax
NTSTATUS FsRtlInsertPerStreamContext(
PFSRTL_ADVANCED_FCB_HEADER PerStreamContext,
[in] PFSRTL_PER_STREAM_CONTEXT Ptr
);
Parameter
PerStreamContext
Zeiger auf die FSRTL_ADVANCED_FCB_HEADER-Struktur für den Dateistream. Um diesen Zeiger aus einem Dateiobjekt abzurufen, verwenden Sie das Makro FsRtlGetPerStreamContextPointer .
[in] Ptr
Zeiger auf eine FSRTL_PER_STREAM_CONTEXT Struktur, die der Filtertreiber zugeordnet und initialisiert hat. Verwenden Sie zum Initialisieren dieser Struktur das Makro FsRtlInitPerStreamContext .
Rückgabewert
FsRtlInsertPerStreamContext gibt einen der folgenden NTSTATUS-Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
Der Aufruf von FsRtlInsertPerStreamContext war erfolgreich. |
|
Das zugrunde liegende Dateisystem unterstützt keine Filterkontexte. |
Hinweise
Ein Dateisystemfiltertreiber ruft FsRtlInsertPerStreamContext auf, um eine eigene Pro-Stream-Kontextstruktur einem Dateistream zuzuordnen. Die Kontextstruktur pro Stream enthält Kontextinformationen, die der Filtertreiber für den Dateistream verwaltet.
Nachdem die Kontextstruktur pro Stream einem Dateistream zugeordnet wurde, kann sie durch Aufrufen von FsRtlLookupPerStreamContext oder durch Aufrufen von FsRtlRemovePerStreamContext abgerufen werden.
Weitere Informationen finden Sie unter Nachverfolgen Per-Stream Kontexts in einem Legacy-Dateisystemfiltertreiber.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 SP4-Updaterollup; Windows XP |
| Zielplattform | Universell |
| Header | ntifs.h (include Ntifs.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |
Weitere Informationen
FsRtlGetPerStreamContextPointer