функция обратного вызова DUMP_READ (ntdddump.h)

Статья
02/07/2025

Подпрограмма обратного вызова Dump_Read вызывается после чтения из драйвера порта дампа. Драйвер фильтра может получить доступ к данным дампа во время вызова этой подпрограммы.

Синтаксис

DUMP_READ DumpRead;

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

Параметры

[in] FilterExtension

Указатель на структуру FILTER_EXTENSION.

[in] DiskByteOffset

Значение в байтах относительно исходного раздела для аварийного дампа или гибернации. Драйверы фильтров не должны изменять это поле.

[in] Mdl

Указатель на структуру MDL, описывающую буфер данных, содержащий данные дампа. Драйверы фильтров не должны изменять это поле.

Возвращаемое значение

Если подпрограмма успешно выполнена, она должна вернуться STATUS_SUCCESS. В противном случае он должен вернуть одно из значений состояния ошибки, определенных в Ntstatus.h.

Замечания

Драйверы фильтров могут считывать данные, считываемые процессом аварийного выполнения.

Драйверы фильтров могут изменять содержимое буфера данных, содержащегося в Mdl, чтобы вернуть все изменения, внесенные в данные при записи на диск.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно начиная с Windows 8
целевая платформа	Настольный
заголовка	ntdddump.h (include Ntdddump.h)

См. также

Dump_Write

FILTER_EXTENSION

Поделиться через