FltGetStreamContext-Funktion (fltkernel.h)
Die FltGetStreamContext Routine ruft einen Kontext ab, der für einen Dateidatenstrom von einer bestimmten Minifiltertreiberinstanz festgelegt wurde.
Syntax
NTSTATUS FLTAPI FltGetStreamContext(
[in] PFLT_INSTANCE Instance,
[in] PFILE_OBJECT FileObject,
[out] PFLT_CONTEXT *Context
);
Parameter
[in] Instance
Undurchsichtiger Instanzzeiger für die Minifiltertreiberinstanz, deren Kontext abgerufen werden soll.
[in] FileObject
Zeigen Sie auf ein Dateiobjekt für den Datenstrom.
[out] Context
Zeiger auf eine vom Aufrufer zugewiesene Variable, die die Adresse des Kontexts empfängt. Dieser Parameter ist erforderlich und kann nicht auf NULL festgelegt werden.
Rückgabewert
FltGetStreamContext gibt STATUS_SUCCESS zurück, wenn der angeforderte Kontext erfolgreich zurückgegeben wird. Andernfalls wird ein entsprechender NTSTATUS-Wert zurückgegeben, z. B. einen der folgenden:
Rückgabecode | Beschreibung |
---|---|
STATUS_NOT_FOUND | Derzeit wurde in dieser Datei kein Abgleichskontext gefunden, sodass FltMgrContext auf NULL_CONTEXT festlegen. Dies ist ein Fehlercode. |
STATUS_NOT_SUPPORTED | Das Dateisystem unterstützt keine Datenstromkontexte für diesen Dateidatenstrom. Dies ist ein Fehlercode. |
Bemerkungen
Weitere Informationen zu Kontexten finden Sie unter Informationen zu Minifilterkontexten.
FltGetStreamContext ruft einen Kontext ab, der für einen Dateidatenstrom von einer bestimmten Minifiltertreiberinstanz festgelegt wurde.
FltGetStreamContext die Verweisanzahl für den Kontext erhöht, auf den der Context Parameter verweist. Wenn dieser Kontextzeiger nicht mehr benötigt wird, muss der Aufrufer seine Verweisanzahl erhöhen, indem FltReleaseContext-aufgerufen wird. Daher muss jeder erfolgreiche Aufruf von FltGetStreamContext durch einen nachfolgenden Aufruf von FltReleaseContextabgeglichen werden.
Rufen Sie FltSetStreamContextauf, um einen Kontext für einen Dateidatenstrom festzulegen.
Rufen Sie FltAllocateContextauf, um einen neuen Kontext zuzuweisen.
Rufen Sie zum Löschen eines Datenstromkontexts FltDeleteStreamContext oder FltDeleteContext-auf.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform- | Universal |
Header- | fltkernel.h (include Fltkernel.h) |
Library | FltMgr.lib |
DLL- | Fltmgr.sys |
IRQL- | <= APC_LEVEL |