Función FltGetNewSystemBufferAddress (fltkernel.h)

La función FltGetNewSystemBufferAddress recupera el búfer AssociatedIrp.SystemBuffer, que el sistema de archivos ha asignado. Una rutina de devolución de llamada posterior al controlador de minifiltro llama a esta función.

Sintaxis

PVOID FLTAPI FltGetNewSystemBufferAddress(
  [in] PFLT_CALLBACK_DATA CallbackData
);

Parámetros

[in] CallbackData

Puntero a una estructura FLT_CALLBACK_DATA que representa una operación de E/S.

Valor devuelto

Si el sistema de archivos asignó el búfer AssociatedIrp.SystemBuffer, FltGetNewSystemBufferAddress devuelve un puntero a este búfer; de lo contrario, devuelve null.

Observaciones

Una rutina de devolución de llamada posterior al controlador de minifiltro llama a función FltGetNewSystemBufferAddress para recuperar un puntero al búfer AssociatedIrp.SystemBuffer que el sistema de archivos ha asignado. Un controlador de minifiltro debe llamar a esta función solo cuando la marca de FLTFL_CALLBACK_DATA_NEW_SYSTEM_BUFFER esté establecida en CallbackData.Flags.

Cuando el sistema de archivos asigna su propio búfer AssociatedIrp.SystemBuffer, el Administrador de filtros establecerá la marca FLTFL_CALLBACK_DATA_NEW_SYSTEM_BUFFER. Esto indica al minifiltro que el búfer que recibieron en la operación previa no es el que tiene los datos leídos del sistema de archivos.

Si no se establece la marca de FLTFL_CALLBACK_DATA_NEW_SYSTEM_BUFFER, esta rutina devuelve NULL.

Requisitos

Consulte también

FLT_CALLBACK_DATA