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,以确保微型端口用来生成转储文件或休眠文件的内存已标识。 当 PORT_CONFIGURATION_INFORMATION 的 DumpMode 成员设置为 DUMP_MODE_MARK_MEMORY 或 DUMP_MODE_HIBER时,微型端口至少应调用 StorPortMarkDumpMemory。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows 8 |
目标平台 | 普遍 |
标头 | storport.h (包括 Storport.h) |
IRQL | 任何 |