MmAllocateNodePagesForMdlEx 函数 (wdm.h)

项目
02/29/2024

MmAllocateNodePagesForMdlEx 例程从理想节点分配非分页物理内存，并分配 MDL 结构来描述此内存。

语法

PMDL MmAllocateNodePagesForMdlEx(
  [in] PHYSICAL_ADDRESS    LowAddress,
  [in] PHYSICAL_ADDRESS    HighAddress,
  [in] PHYSICAL_ADDRESS    SkipBytes,
  [in] SIZE_T              TotalBytes,
  [in] MEMORY_CACHING_TYPE CacheType,
  [in] ULONG               IdealNode,
  [in] ULONG               Flags
);

参数

[in] LowAddress

第一个地址的开头的物理地址范围，分配的页面可以从中出现。如果 MmAllocateNodePagesForMdlEx 无法在第一个地址范围内分配请求的字节数，则例程会循环访问其他地址范围以获取更多页。每次迭代时， MmAllocateNodePagesForMdlEx 都会将 SkipBytes 的值添加到上一个起始地址，以计算下一个地址范围的开头。

[in] HighAddress

分配的页面可能来自的第一个地址范围末尾的物理地址。

[in] SkipBytes

要从上一个地址范围的开头跳过已分配页的字节数。 SkipBytes 必须是虚拟内存页大小的整数倍（以字节为单位）。

[in] TotalBytes

要为 MDL 分配的字节总数。

[in] CacheType

MEMORY_CACHING_TYPE值，该值指示所请求内存允许的缓存类型。

[in] IdealNode

理想的节点数。如果多处理器系统包含 N 个节点，则有效节点编号在 0 到 N-1 的范围内。驱动程序可以调用 KeQueryHighestNodeNumber 例程来获取最高节点数。单处理器或非 NUMA 多处理器系统只有一个节点（节点 0）从中分配内存。对于 NUMA 多处理器系统，如果可能，则从理想节点进行分配。如果理想节点中内存不足，无法满足分配请求，并且调用方未设置MM_ALLOCATE_FROM_LOCAL_NODE_ONLY标志， 则 MmAllocateNodePagesForMdlEx 将尝试从其他节点分配内存。

[in] Flags

此操作的标志。将此参数设置为零或以下一个或多个标志位的按位 OR：

MM_DONT_ZERO_ALLOCATION
MM_ALLOCATE_FROM_LOCAL_NODE_ONLY
MM_ALLOCATE_FULLY_REQUIRED
MM_ALLOCATE_NO_WAIT
MM_ALLOCATE_PREFER_CONTIGUOUS
MM_ALLOCATE_REQUIRE_CONTIGUOUS_CHUNKS
MM_ALLOCATE_AND_HOT_REMOVE

有关这些标志的详细信息，请参阅 MM_ALLOCATE_XXX。

返回值

MmAllocateNodePagesForMdlEx 返回指向 MDL 结构的指针（如果成功）。否则，如果例程无法分配任何内存，则例程将返回 NULL。

返回值为 NULL 表示指定的地址范围内没有可用的物理内存页，或者没有足够的内存池可用于分配 MDL 结构。

如果例程成功分配了部分（但不是全部）请求的内存，则 MDL 描述与例程能够分配的内存一样多的物理内存。

注解

在非统一内存访问 (NUMA) 多处理器系统中，调用方可以指定要从中分配内存的理想节点。节点是共享对内存区域的快速访问的处理器集合。在非 NUMA 多处理器或单处理器系统中， MmAllocateNodePagesForMdlEx 将所有内存视为属于单个节点，并从此节点分配内存。

默认情况下， MmAllocateNodePagesForMdlEx 返回的物理内存页不是连续页。调用方可以通过在 Flags 参数中设置MM_ALLOCATE_PREFER_CONTIGUOUS或MM_ALLOCATE_REQUIRE_CONTIGUOUS_CHUNKS标志位来替代此例程的默认行为。

MmAllocateNodePagesForMdlEx 不会将分配的物理内存映射到虚拟内存。如有必要，调用方可以调用例程（如 MmMapLockedPagesSpecifyCache ）来映射 MDL 描述的物理内存页。

MmAllocateNodePagesForMdlEx 专为不需要相应虚拟地址的内核模式驱动程序设计， (即，它们需要物理页面，不需要物理页面) 物理连续，而对于内核模式驱动程序，如果设备的物理内存在特定物理地址范围内分配， (例如， AGP 图形卡) 。

根据请求范围中当前可用的物理内存量， MmAllocateNodePagesForMdlEx 可能会返回描述比请求的内存少的 MDL。如果未分配内存，例程也可能返回 NULL 。调用方应检查实际分配的内存量，如 MDL 所述。

调用方必须使用 MmFreePagesFromMdl 释放由 MmAllocateNodePagesForMdlEx 创建的 MDL 描述的内存页。调用 MmFreePagesFromMdl 后，调用方还必须调用 ExFreePool 以释放为 MDL 结构分配的内存。

默认情况下， MmAllocateNodePagesForMdlEx 会用零填充它分配的页面。调用方可以指定MM_DONT_ZERO_ALLOCATION标志来替代此默认值并可能提高性能。

如果指定 MM_DONT_ZERO_ALLOCATION 标志， 则 MmAllocateNodePagesForMdlEx 分配的内存未初始化。如果驱动程序要使内存对用户模式软件可见 (，则内核模式驱动程序必须首先将内存归零，以避免泄露) 潜在的特权内容。有关此标志的详细信息，请参阅 MM_ALLOCATE_XXX。

MmAllocateNodePagesForMdlEx 在单个调用中可以分配的最大内存量为 (4 GB - PAGE_SIZE) 。仅当有足够的页面可用时，例程才能满足此数量的分配请求。

MmAllocateNodePagesForMdlEx 在 IRQL <= APC_LEVEL 运行。如有必要，驱动程序可以在 DISPATCH_LEVEL 调用 MmAllocateNodePagesForMdlEx 。但是，可以通过在 APC_LEVEL 或以下位置调用来提高驱动程序性能。

要求

要求	值
最低受支持的客户端	从Windows 8开始可用。
目标平台	通用
标头	wdm.h（包括 Wdm.h、Ntddk.h、Ntifs.h）
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL (请参阅备注部分。)