mmBuildMdlForNonPagedPool 函数 (wdm.h)

项目
02/29/2024

MmBuildMdlForNonPagedPool 例程接收指定非分页虚拟内存缓冲区的 MDL，并更新它以描述基础物理页。

语法

void MmBuildMdlForNonPagedPool(
  [in, out] PMDL MemoryDescriptorList
);

参数

[in, out] MemoryDescriptorList

指向 MDL 的指针，该指针指定非分页内存中的虚拟内存缓冲区。调用方使用 IoAllocateMdl 例程为此缓冲区创建 MDL。

返回值

无

备注

在输入时，指定的 MDL 必须描述非分页系统内存或锁定的内存中的缓冲区， (物理页面不能) 交易，例如内存由 ExAllocatePoolWithTag 例程与 PoolType = NonPagedPool 或 MmAllocateContiguousMemorySpecifyCache 例程分配。 MmBuildMdlForNonPagedPool 更新 MDL 以描述基础物理页。

MmBuildMdlForNonPagedPool 不能与描述在内核堆栈上分配的缓冲区的 MDL 一起使用。若要生成描述内核堆栈缓冲区的 MDL，驱动程序必须调用 MmProbeAndLockPages。这是因为内核堆栈页可以交易，除非它们是探测和锁定的。即使驱动程序保证内核堆栈无法分页，此规则也适用。

由于 MDL 描述的页面已经不可分页，并且已映射到系统地址空间，因此驱动程序不得尝试使用 MmProbeAndLockPages 例程来锁定它们，也不得尝试使用 MmMapLockedPagesSpecifyCache 例程创建其他系统地址空间映射。同样，驱动程序不得尝试使用 MmUnlockPages 例程解锁页面，也不得使用 MmUnmapLockedPages 例程释放现有的系统地址空间映射。如果驱动程序对 由 MmBuildMdlForNonPagedPool 生成的 MDL 执行任何这些非法操作，则生成的行为是未定义的。

允许将 MmBuildMdlForNonPagedPool 生成的 MDL 传递给 MmGetSystemAddressForMdlSafe 例程。在本例中， MmGetSystemAddressForMdlSafe 调用仅返回 MDL 描述的缓冲区的起始虚拟地址。

驱动程序可以使用 MmMapLockedPagesSpecifyCache 例程将 MmBuildMdlForNonPagedPool 生成的 MDL 映射到用户虚拟地址空间。但是，驱动程序必须以避免某些安全问题的方式执行此操作。有关详细信息，请参阅 MmMapLockedPagesSpecifyCache。

要求

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