StorPortMarkDumpMemory 函数 (storport.h)

项目
02/29/2024

微型端口应标记用于转储文件或休眠文件的内存。标记的内存将保留，并在从休眠操作恢复后保持有效。要标记的内存由调用 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，则标记包含 Address 的整个部分。

微型端口驱动程序应调用 StorPortMarkDumpMemory ，以确保标识微型端口用于生成转储文件或休眠文件的内存。当 PORT_CONFIGURATION_INFORMATION 的 DumpMode 成员设置为 DUMP_MODE_MARK_MEMORY 或DUMP_MODE_HIBER 时，微型端口至少应调用 StorPortMarkDumpMemory。