StorPortMarkDumpMemory routine

A miniport should mark memory used for the dump file or the hibernation file. Marked memory is retained and remains valid after a resume from hibernation operation. The memory to mark is specified by an address and range length in a call to StorPortMarkDumpMemory.

Syntax


ULONG StorPortMarkDumpMemory(
  _In_  PVOID HwDeviceExtension,
  _In_  PVOID Address,
  _In_  PVOID Length,
  _In_  PVOID Flags
);

Parameters

HwDeviceExtension [in]

A pointer to the hardware device extension for the host bus adapter (HBA).

Address [in]

The starting address of the memory range to mark.

Length [in]

The length of the marked memory range.

Flags [in]

Dump memory marking flags. The Flags parameter must be 0 or contain only the following value.

ValueMeaning
MARK_DUMP_MEMORY_FLAG_PHYSICAL_ADDRESS

The address provided in Address is a physical address and not a system virtual address.

 

Return value

StorPortMarkDumpMemory returns one of the following status codes:

Return codeDescription
STOR_STATUS_SUCCESS

Indicates that the routine set the unit attributes successfully.

STOR_STATUS_INVALID_PARAMETER

An invalid flag value was specified in the Flags parameter.

 

Remarks

The StorPortMarkDumpMemory routine must only be called by a miniport driver in its DriverEntry or HwStorFindAdapter routines.

If Length = 0, the entire section containing Address is marked.

Miniport drivers should call StorPortMarkDumpMemory to ensure that the memory used by the miniport to generate either the dump file or the hibernation file is identified. At a minimum, miniports should call StorPortMarkDumpMemory when the DumpMode member of PORT_CONFIGURATION_INFORMATION is set to either DUMP_MODE_MARK_MEMORY or DUMP_MODE_HIBER.

Requirements

Version

Available starting with Windows 8.

Header

Storport.h (include Storport.h)

IRQL

Any

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft