DUMP_WRITE función de devolución de llamada (ntdddump.h)

  • Artículo

Se llama a la rutina de devolución de llamada Dump_Write antes de escribir en el controlador de puerto de volcado. El controlador de filtro puede acceder a los datos de volcado de memoria en este momento.

Sintaxis

DUMP_WRITE DumpWrite;

NTSTATUS DumpWrite(
  [in]      PFILTER_EXTENSION FilterExtension,
  [in, out] PLARGE_INTEGER DiskByteOffset,
  [in, out] PMDL Mdl
)
{...}

Parámetros

[in] FilterExtension

Puntero a una estructura FILTER_EXTENSION .

[in, out] DiskByteOffset

Valor, en bytes, relativo a la partición de destino para el volcado de memoria o hibernación. Los controladores de filtro no deben modificar este campo.

[in, out] Mdl

Puntero a una estructura MDL que describe el búfer de datos. Si se modifica mdL , el tamaño de la operación de escritura no puede cambiar.

Valor devuelto

Si la rutina se realiza correctamente, debe devolver STATUS_SUCCESS. De lo contrario, debe devolver uno de los valores de estado de error definidos en Ntstatus.h.

Comentarios

Los controladores de filtro pueden leer los datos que deben escribirse. Sin embargo, los controladores de filtro no pueden escribir en el búfer, ya que esto podría cambiar el contenido del código o los datos que usa el proceso de volcado de memoria. Además, no se permite que los controladores de filtro cambien el tamaño de los datos.

Para modificar de forma segura los datos de la escritura de volcado de memoria, un controlador de filtro debe asignar un búfer secundario. El tamaño del búfer será el valor del miembro MaxPagesPerWrite de FILTER_INITIALIZATION_DATA multiplicado por PAGE_SIZE. Los datos del búfer actual descrito por Mdl se copian en el búfer secundario y se procesan. Una vez que el filtro haya terminado de controlar los datos de volcado en el búfer secundario, mdl al que apunta Mdl se actualiza con la dirección del búfer secundario. La dirección inicial del búfer secundario establecido en MDL debe estar alineada con la página.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible a partir de Windows Vista y Windows Server 2008.
Plataforma de destino Escritorio
Encabezado ntdddump.h (incluya Ntdddump.h)

Consulte también

Dump_Read

FILTER_EXTENSION

FILTER_INITIALIZATION_DATA