FltGetSectionContext-Funktion (fltkernel.h)
Die FltGetSectionContext Routine ruft einen Abschnittskontext ab, der für einen Dateidatenstrom von einer angegebenen Minifiltertreiberinstanz erstellt wurde.
Syntax
NTSTATUS FLTAPI FltGetSectionContext(
[in] PFLT_INSTANCE Instance,
[in] PFILE_OBJECT FileObject,
[out] PFLT_CONTEXT *Context
);
Parameter
[in] Instance
Ein undurchsichtiger Instanzzeiger für die Minifiltertreiberinstanz, deren Kontext abgerufen werden soll.
[in] FileObject
Ein Zeiger auf ein Dateiobjekt für den Datenstrom.
[out] Context
Ein 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
FltGetSectionContext- gibt STATUS_SUCCESS zurück, wenn der angeforderte Abschnittskontext erfolgreich zurückgegeben wird. Andernfalls wird ein entsprechender NTSTATUS-Wert zurückgegeben, z. B. einer 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 an diese Instanz angefügte Volume unterstützt keine Abschnittskontexte. Dies ist ein Fehlercode. |
Bemerkungen
Weitere Informationen zu Kontexten finden Sie unter Informationen zu Minifilterkontexten.
FltGetSectionContext ruft einen Abschnittskontext ab, der für einen Dateidatenstrom von einer angegebenen Minifiltertreiberinstanz erstellt wurde. Ein Abschnittskontext wird durch Aufrufen von FltCreateSectionForDataScanerstellt.
FltGetSectionContext die Verweisanzahl im 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 FltGetSectionContext mit einem nachfolgenden Aufruf von FltReleaseContextabgeglichen werden.
Rufen Sie FltAllocateContextauf, um einen neuen Kontext zuzuweisen.
Minifilter dürfen keinen expliziten Abschnittskontext löschen, der an FltCreateSectionForDataScanübergeben wird. Ein Abschnittskontext wird durch Aufrufen von FltCloseSectionForDataScan- aus einem Datenstrom entfernt.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 8 |
| Zielplattform- | Universal |
| Header- | fltkernel.h (include Fltkernel.h) |
| Library | FltMgr.lib |
| DLL- | Fltmgr.sys |
| IRQL- | <= APC_LEVEL |