Dump_Read routine

The Dump_Read callback routine is called after the read from the dump port driver. The filter driver can access the dump data during the call to this routine.

Syntax


PDUMP_READ Dump_Read;

NTSTATUS Dump_Read(
  _In_ PFILTER_EXTENSION FilterExtension,
  _In_ PLARGE_INTEGER    DiskByteOffset,
  _In_ PMDL              Mdl
)
{ ... }

Parameters

FilterExtension [in]

A pointer to a FILTER_EXTENSION structure.

DiskByteOffset [in]

The value, in bytes, relative to the source partition for the crash dump or hibernation. Filter drivers should not modify this field.

Mdl [in]

A pointer to an MDL structure that describes the data buffer containing the dump data. Filter drivers should not modify this field.

Return value

If the routine succeeds, it must return STATUS_SUCCESS. Otherwise, it must return one of the error status values defined in Ntstatus.h.

Remarks

Filter drivers can read the data that was read by the crashdump process.

Filter drivers can modify the contents of the data buffer contained in Mdl to revert any changes made to the data when it was written to disk.

Requirements

Target platform

Version

Available starting with Windows 8

Header

Ntdddump.h (include Ntdddump.h)

See also

Dump_Write
FILTER_EXTENSION

 

 

Send comments about this topic to Microsoft

Show: