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


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

Мини-порт должен помечать память, используемую для файла дампа или файла гибернации. Помеченная память сохраняется и остается действительной после возобновления операции гибернации. Память для пометки указывается адресом и длиной диапазона при вызове 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 должна вызываться только драйвером мини-порта в подпрограммах DriverEntry или HwStorFindAdapter .

Если length = 0, помечается весь раздел , содержащий Адрес .

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

Требования

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

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

DriverEntry

HwStorFindAdapter

PORT_CONFIGURATION_INFORMATION