FltGetNewSystemBufferAddress-Funktion (fltkernel.h)
Die FltGetNewSystemBufferAddress Funktion ruft den AssociatedIrp.SystemBuffer-Puffer ab, den das Dateisystem zugewiesen hat. Die Nachrückrufroutine eines Minifiltertreibers ruft diese Funktion auf.
Syntax
PVOID FLTAPI FltGetNewSystemBufferAddress(
[in] PFLT_CALLBACK_DATA CallbackData
);
Parameter
[in] CallbackData
Ein Zeiger auf eine FLT_CALLBACK_DATA Struktur, die einen E/A-Vorgang darstellt.
Rückgabewert
Wenn der AssociatedIrp.SystemBuffer-Puffer vom Dateisystem zugewiesen wurde, gibt FltGetNewSystemBufferAddress einen Zeiger auf diesen Puffer zurück; andernfalls wird NULL-zurückgegeben.
Bemerkungen
Die Post-Callback-Routine eines Minifiltertreibers ruft FltGetNewSystemBufferAddress Funktion auf, um einen Zeiger auf den AssociatedIrp.SystemBuffer-Puffer abzurufen, den das Dateisystem zugewiesen hat. Ein Minifiltertreiber sollte diese Funktion nur aufrufen, wenn das FLTFL_CALLBACK_DATA_NEW_SYSTEM_BUFFER Flag in CallbackData.Flagsfestgelegt ist.
Wenn das Dateisystem einen eigenen AssociatedIrp.SystemBuffer-Puffer zuweist, legt der Filter-Manager das FLTFL_CALLBACK_DATA_NEW_SYSTEM_BUFFER Flag fest. Dadurch wird der Minifilter signalisiert, dass der im Vorvorgang empfangene Puffer nicht der Filter ist, der die Daten aus dem Dateisystem gelesen hat.
Wenn das FLTFL_CALLBACK_DATA_NEW_SYSTEM_BUFFER Flag nicht festgelegt ist, gibt diese Routine NULL-zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Microsoft Windows 7 und höheren Versionen des Windows-Betriebssystems. |
| Zielplattform- | Universal |
| Header- | fltkernel.h (include Fltkernel.h) |
| Library | Fltmgr.lib |
| DLL- | Fltmgr.sys |
| IRQL- | <= DISPATCH_LEVEL |