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

如果 Length = 0,则标记包含 Address 的整个部分。

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

要求

要求
最低受支持的客户端 Windows 8
目标平台 通用
标头 storport.h (包括 Storport.h)
IRQL 任意

另请参阅

DriverEntry

HwStorFindAdapter

PORT_CONFIGURATION_INFORMATION