FsRtlInsertPerStreamContext-Funktion (ntifs.h)
Die FsRtlInsertPerStreamContext Routine ordnet die Kontextstruktur eines Dateisystemfiltertreibers einem Dateidatenstrom zu.
Syntax
NTSTATUS FsRtlInsertPerStreamContext(
PFSRTL_ADVANCED_FCB_HEADER PerStreamContext,
[in] PFSRTL_PER_STREAM_CONTEXT Ptr
);
Parameter
PerStreamContext
Zeigen Sie auf die FSRTL_ADVANCED_FCB_HEADER Struktur für den Dateidatenstrom. Um diesen Zeiger aus einem Dateiobjekt abzurufen, verwenden Sie das FsRtlGetPerStreamContextPointer Makro.
[in] Ptr
Zeigen Sie auf eine FSRTL_PER_STREAM_CONTEXT Struktur, die der Filtertreiber zugewiesen und initialisiert hat. Verwenden Sie zum Initialisieren dieser Struktur das FsRtlInitPerStreamContext Makro.
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. |
Bemerkungen
Ein Dateisystemfiltertreiber ruft FsRtlInsertPerStreamContext- auf, um eine eigene Kontextstruktur pro Stream einem Dateidatenstrom zuzuordnen. Die Kontextstruktur pro Datenstrom enthält Kontextinformationen, die der Filtertreiber für den Dateidatenstrom verwaltet.
Nachdem die Kontextstruktur pro Stream einem Dateidatenstrom zugeordnet wurde, kann sie abgerufen werden, indem FsRtlLookupPerStreamContext aufgerufen oder entfernt werden, indem FsRtlRemovePerStreamContextaufgerufen wird.
Weitere Informationen finden Sie unter Tracking Per-Stream Context in einem Legacy File System Filter Driver.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 2000 SP4 Update Rollup; Windows XP |
| Zielplattform- | Universal |
| Header- | ntifs.h (einschließlich Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | <= APC_LEVEL |
Siehe auch
FsRtlGetPerStreamContextPointer-