MmAllocateContiguousMemorySpecifyCacheNode 函数 (wdm.h)

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

语法

PVOID MmAllocateContiguousMemorySpecifyCacheNode(
  [in]           SIZE_T              NumberOfBytes,
  [in]           PHYSICAL_ADDRESS    LowestAcceptableAddress,
  [in]           PHYSICAL_ADDRESS    HighestAcceptableAddress,
  [in, optional] PHYSICAL_ADDRESS    BoundaryAddressMultiple,
  [in]           MEMORY_CACHING_TYPE CacheType,
  [in]           NODE_REQUIREMENT    PreferredNode
);

参数

[in] NumberOfBytes

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

[in] LowestAcceptableAddress

调用方可以使用的最低有效物理地址。 例如,如果设备只能解决处理器物理内存地址范围前 8 兆字节以上的位置,则此设备的驱动程序应将 LowestAcceptableAddress 设置为0x0000000000800000。

[in] HighestAcceptableAddress

调用方可以使用的最高有效物理地址。 例如,如果设备只能处理处理器物理内存地址范围前 16 兆字节的位置,则此设备的驱动程序应将 HighestAcceptableAddress 设置为0x0000000000FFFFFF。

[in, optional] BoundaryAddressMultiple

分配的缓冲区不能交叉的物理地址。 物理地址倍数必须始终为两个电源。 此参数是可选的,可以指定为零,以指示设备没有特殊的内存边界限制。 有关详细信息,请参阅“备注”。

[in] CacheType

指定一个 MEMORY_CACHING_TYPE 值,该值指示为连续物理内存请求的缓存类型。

[in] PreferredNode

首选节点编号。 如果多处理器系统包含 N 个节点,则节点编号为 0 到 N-1。 如果指定了MM_ANY_NODE_OK,或者计算机只有一个节点,则从任何节点满足分配。 否则,将从首选节点进行分配,或者如果无法从首选节点找到令人满意的范围,则返回 NULL

返回值

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

注解

内核模式设备驱动程序调用此例程来分配连续的物理内存块。 在非统一内存访问 (NUMA) 多处理器系统中,调用方可以指定要从中分配内存的首选节点。 节点是一组处理器,可共享对内存区域的快速访问。 在非 NUMA 多处理器或单处理器系统中, MmAllocateContiguousMemorySpecifyCacheNode 将所有内存视为属于单个节点并从此节点分配内存。

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

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

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

不再需要内存时,必须释放 MmAllocateContiguousMemorySpecifyCacheNode 分配的内存。 调用 MmFreeContiguousMemory 例程以释放 MmAllocateContiguousMemorySpecifyCacheNode 分配的内存。

如果为 BoundaryAddressMultiple 参数指定了非零值,则分配的内存块的物理地址范围不会跨越此值的整数倍的地址边界。 除非需要非零值才能解决硬件限制,否则驱动程序应将此参数设置为零。 例如,如果设备无法跨 16 兆字节的物理边界传输数据,驱动程序应为此参数指定0x1000000值,以确保设备看到的地址不会环绕在 16 兆字节边界处。

注意 如果在内存量较大的计算机上使用 MmAllocateContiguousMemorySpecifyCacheNode 例程,则当系统尝试创建连续内存块时,操作系统的性能可能会严重降级。 从 Windows Vista SP1 和 Windows Server 2008 开始,这种下降大大减少了,但连续内存仍可能很昂贵。 因此,驱动程序应避免重复调用 MmAllocateContiguousMemorySpecifyCacheNode。 相反,驱动程序应在其 DriverEntry 例程中分配所有必需的连续缓冲区,并重复使用这些缓冲区。
 
注意MmAllocateContiguousMemorySpecifyCacheNode 分配的内存未初始化。 如果内核模式驱动程序要使用户模式软件 (可见,则必须先将此内存设置为零,以避免) 泄露潜在的特权内容。
 

要求

   
最低受支持的客户端 从 Windows Vista 开始可用。
目标平台 通用
标头 wdm.h (包括 Wdm.h、Ntddk.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL

请参阅

DriverEntry

MEMORY_CACHING_TYPE

MmFreeContiguousMemory