Функция StorPortMarkDumpMemory (storport.h)

Статья
06/15/2023

Мини-порт должен помечать память, используемую для файла дампа или файла гибернации. Помеченная память сохраняется и остается действительной после возобновления операции гибернации. Память для пометки указывается адресом и длиной диапазона при вызове StorPortMarkDumpMemory.

Синтаксис

ULONG StorPortMarkDumpMemory(
  [in] PVOID     HwDeviceExtension,
  [in] PVOID     Address,
  [in] ULONG_PTR Length,
  [in] ULONG     Flags
);

Параметры

[in] HwDeviceExtension

Указатель на расширение аппаратного устройства для адаптера шины узла (HBA).

[in] Address

Начальный адрес диапазона памяти для пометки.

[in] Length

Длина отмеченного диапазона памяти.

[in] Flags

Флаги маркировки памяти дампа. Параметр Flags должен иметь значение 0 или содержать только следующее значение.

Значение	Значение
MARK_DUMP_MEMORY_FLAG_PHYSICAL_ADDRESS	Адрес, указанный в поле Адрес , является физическим, а не системным виртуальным адресом.

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

StorPortMarkDumpMemory возвращает один из следующих кодов состояния:

Код возврата	Описание
STOR_STATUS_SUCCESS	Указывает, что подпрограмма успешно задает атрибуты единиц измерения.
STOR_STATUS_INVALID_PARAMETER	В параметре Flags указано недопустимое значение флага .

Драйверы мини-портов должны вызывать StorPortMarkDumpMemory , чтобы убедиться, что память, используемая мини-портом для создания файла дампа или файла гибернации, определена. Как минимум, минипорты должны вызывать StorPortMarkDumpMemory , если член DumpModePORT_CONFIGURATION_INFORMATION имеет значение DUMP_MODE_MARK_MEMORY или DUMP_MODE_HIBER.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8
Целевая платформа	Универсальное
Верхняя часть	storport.h (включая Storport.h)
IRQL	Любой

См. также раздел

DriverEntry

HwStorFindAdapter

PORT_CONFIGURATION_INFORMATION

Share via