estructura FILTER_INITIALIZATION_DATA (ntdddump.h)

Artículo
08/07/2023

El controlador de filtro rellena una estructura de FILTER_INITIALIZATION_DATA y la devuelve al controlador de volcado de memoria.

Sintaxis

typedef struct _FILTER_INITIALIZATION_DATA {
  ULONG        MajorVersion;
  ULONG        MinorVersion;
  PDUMP_START  DumpStart;
  PDUMP_WRITE  DumpWrite;
  PDUMP_FINISH DumpFinish;
  PDUMP_UNLOAD DumpUnload;
  PVOID        DumpData;
  ULONG        MaxPagesPerWrite;
  ULONG        Flags;
  PDUMP_READ   DumpRead;
} FILTER_INITIALIZATION_DATA, *PFILTER_INITIALIZATION_DATA;

Miembros

MajorVersion

Establezca en uno de los siguientes valores de versión principal:

DUMP_FILTER_MAJOR_VERSION_1 (0x1)

DUMP_FILTER_MAJOR_VERSION (0x2)

MinorVersion

Establezca en DUMP_FILTER_MINOR_VERSION.

DumpStart

Puntero a la rutina de inicialización de volcado de memoria. Se llama a esta rutina cuando se inicia el volcado de memoria.

DumpWrite

Puntero a la rutina de escritura. Se llama a esta rutina antes de cada solicitud de escritura de volcado de memoria.

DumpFinish

Puntero a la rutina de finalización del volcado de memoria. Se llama a esta rutina cuando finaliza el volcado de memoria.

DumpUnload

Puntero a la rutina de descarga de volcado. Se llama a esta rutina antes de descargar el controlador.

DumpData

El controlador de filtro puede pasar un puntero a los datos de contexto internos de este miembro. Este puntero se devuelve al controlador de filtro en una estructura de FILTER_EXTENSION durante cada devolución de llamada.

MaxPagesPerWrite

Número máximo de páginas para cada solicitud de lectura o escritura de volcado.

Flags

Conjunto de marcas para la inicialización del filtro de volcado. Este valor se establece en 0 o en lo siguiente:

Valor	Significado
DUMP_FILTER_FLAG_SYSTEM_SUPPORT_READ	El filtro de volcado de memoria admite lecturas de filtrado y se establece una rutina de devolución de llamada de lectura para DumpRead. Esta marca se admite a partir de Windows 8.
DUMP_FILTER_CRITICAL	Se produce un error en la inicialización del filtro inmediatamente si la rutina DriverEntry del controlador de filtro de volcado no devuelve STATUS_SUCCESS. Esta marca se admite a partir de Windows 8.

DumpRead

Puntero a la rutina de lectura. Se llama a esta rutina después de cada solicitud de lectura de volcado de memoria. Este miembro está disponible a partir de Windows 8.

Comentarios

Para que un controlador de filtro de volcado admita el filtrado de lectura, se requiere la siguiente configuración:

La marca DUMP_FILTER_FLAG_SYSTEM_SUPPORT_READ se establece en Marcas.
MajorVersion se establece en DUMP_FILTER_MAJOR_VERSION = 2.
El puntero DumpRead se establece en la rutina de lectura del controlador de filtro de volcado.

Si no se establece alguno de estos miembros, el controlador de filtro de volcado se marcará como no compatible con las lecturas de volcado por parte de la pila crashdump.