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

Siehe auch

FLT_CALLBACK_DATA