Функция 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 | Любой |