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 例程只能由微型端口驱动程序在其 DriverEntryHwStorFindAdapter 例程中调用。

如果 长度 = 0,则会标记包含 地址 的整个部分。

微型端口驱动程序应调用 StorPortMarkDumpMemory,以确保微型端口用来生成转储文件或休眠文件的内存已标识。 当 PORT_CONFIGURATION_INFORMATIONDumpMode 成员设置为 DUMP_MODE_MARK_MEMORYDUMP_MODE_HIBER时,微型端口至少应调用 StorPortMarkDumpMemory

要求

要求 价值
最低支持的客户端 Windows 8
目标平台 普遍
标头 storport.h (包括 Storport.h)
IRQL 任何

另请参阅

DriverEntry

HwStorFindAdapter

PORT_CONFIGURATION_INFORMATION