mmAllocateContiguousMemory 函数 (wdm.h)

项目
03/08/2023

MmAllocateContiguousMemory 例程分配一系列连续的非分页物理内存，并将其映射到系统地址空间。

语法

PVOID MmAllocateContiguousMemory(
  [in] SIZE_T           NumberOfBytes,
  [in] PHYSICAL_ADDRESS HighestAcceptableAddress
);

参数

[in] NumberOfBytes

要分配的连续内存块的大小（以字节为单位）。有关详细信息，请参阅“备注”。

[in] HighestAcceptableAddress

调用方可以使用的最高有效物理地址。例如，如果设备只能寻址处理器物理内存地址范围前 16 MB 中的位置，则此设备的驱动程序应将 HighestAcceptableAddress 设置为 0x0000000000FFFFFF。如果内存分配没有特定要求，请将设置为 MAXULONG64。

返回值

MmAllocateContiguousMemory 返回已分配内存的基虚拟地址。如果请求无法满足，则例程返回 NULL。

注解

MmAllocateContiguousMemory 分配物理地址空间中连续的非分页内存块。例程将此块映射到系统地址空间中的连续虚拟内存块，并返回此块基的虚拟地址。例程将连续内存分配的起始地址与内存页边界对齐。

驱动程序不能访问超出请求的分配大小的内存。例如，开发人员不应假定其驱动程序可以在请求的分配结束和下一页边界之间安全地使用内存。

由于连续物理内存通常供不应求，因此应谨慎使用，并且仅在必要时使用。必须使用连续内存的驱动程序应在驱动程序初始化期间分配此内存，因为随着操作系统分配和释放内存，物理内存可能会随着时间的推移而碎片化。通常，驱动程序从其 DriverEntry 例程调用 MmAllocateContiguousMemory 来分配内部缓冲区以供长期使用，并在卸载驱动程序之前释放缓冲区。

当不再需要内存时，必须释放 由 MmAllocateContiguousMemory 分配的内存。调用 MmFreeContiguousMemory 例程以释放 由 MmAllocateContiguousMemory 分配的内存。

当物理内存在具有大量 RAM 的计算机上碎片时，调用 MmAllocateContiguousMemory（要求操作系统搜索连续内存块）可能会严重降低性能。从 Windows Vista SP1 和 Windows Server 2008 开始，这种降级会大大减少，但连续内存的分配成本仍然很高。因此，驱动程序应避免重复调用 MmAllocateContiguousMemory。相反，驱动程序应在其 DriverEntry 例程中分配所有必需的连续缓冲区，并重复使用这些缓冲区。

MmAllocateContiguousMemory 分配的内存未初始化。如果内核模式驱动程序要使其对用户模式软件 (可见，则必须先将此内存设置为零，以避免泄露) 潜在的特权内容。