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,则标记包含 Address 的整个部分。
微型端口驱动程序应调用 StorPortMarkDumpMemory ,以确保标识微型端口用于生成转储文件或休眠文件的内存。 当 PORT_CONFIGURATION_INFORMATION 的 DumpMode 成员设置为 DUMP_MODE_MARK_MEMORY 或DUMP_MODE_HIBER 时,微型端口至少应调用 StorPortMarkDumpMemory。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 8 |
目标平台 | 通用 |
标头 | storport.h (包括 Storport.h) |
IRQL | 任意 |