Compartilhar via

DUMP_WRITE função de retorno de chamada (ntdddump.h)

  • Artigo

A rotina de retorno de chamada Dump_Write é chamada antes da gravação no driver da porta de despejo. O driver de filtro pode acessar os dados de despejo no momento.

Sintaxe

DUMP_WRITE DumpWrite;

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

Parâmetros

[in] FilterExtension

Um ponteiro para uma estrutura FILTER_EXTENSION .

[in, out] DiskByteOffset

O valor, em bytes, em relação à partição de destino para o despejo de memória ou hibernação. Os drivers de filtro não devem modificar esse campo.

[in, out] Mdl

Um ponteiro para uma estrutura MDL que descreve o buffer de dados. Se o MDL for modificado, o tamanho da operação de gravação não poderá ser alterado.

Retornar valor

Se a rotina for bem-sucedida, ela deverá retornar STATUS_SUCCESS. Caso contrário, ele deverá retornar um dos valores de status de erro definidos em Ntstatus.h.

Comentários

Os drivers de filtro podem ler os dados que precisam ser gravados. No entanto, os drivers de filtro não podem gravar no buffer, pois isso pode alterar o conteúdo do código ou dos dados que estão sendo usados pelo processo de despejo de memória. Além disso, os drivers de filtro não têm permissão para alterar o tamanho dos dados.

Para modificar com segurança os dados para a gravação de despejo, um driver de filtro deve alocar um buffer secundário. O tamanho do buffer será o valor do membro MaxPagesPerWrite de FILTER_INITIALIZATION_DATA multiplicado por PAGE_SIZE. Os dados do buffer atual descrito pelo Mdl são copiados para o buffer secundário e processados. Depois que o filtro terminar de manipular os dados de despejo no buffer secundário, o MDL apontado por Mdl será atualizado com o endereço do buffer secundário. O endereço inicial do buffer secundário definido no MDL deve ser alinhado à página.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível a partir do Windows Vista e do Windows Server 2008.
Plataforma de Destino Área de Trabalho
Cabeçalho ntdddump.h (include Ntdddump.h)

Confira também

Dump_Read

FILTER_EXTENSION

FILTER_INITIALIZATION_DATA