StorPortMarkDumpMemory - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// storport.h
ULONG StorPortMarkDumpMemory(
[in] PVOID HwDeviceExtension,
[in] PVOID Address,
[in] ULONG_PTR Length,
[in] ULONG Flags
);
View the official Windows Driver Kit DDI referenceNo description available.
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.
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.
| Value | Meaning |
|---|---|
| MARK_DUMP_MEMORY_FLAG_PHYSICAL_ADDRESS | The address provided in Address is a physical address and not a system virtual address. |
StorPortMarkDumpMemory returns one of the following status codes:
| Return code | Description |
|---|---|
| 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. |
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.
PORT_CONFIGURATION_INFORMATION