Функция 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

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

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

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

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

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

Замечания

Подпрограмма StorPortMarkDumpMemory должна вызываться только минипорт-драйвером в его DriverEntry или HwStorFindAdapter подпрограммы.

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

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

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 8
целевая платформа Всеобщий
заголовка storport.h (include Storport.h)
IRQL Любой

См. также

DriverEntry

HwStorFindAdapter

PORT_CONFIGURATION_INFORMATION