ExAllocatePool 宏(classpnp.h)

ExAllocatePool 例程 过时,并且仅导出现有二进制文件。 请改用 ExAllocatePoolWithTag

ExAllocatePool 分配指定类型的池内存,并返回指向已分配块的指针。

语法

PVOID ExAllocatePool(
  _In_ POOL_TYPE a,
  _In_ SIZE_T b
);

参数

a

要分配的池内存的类型。 有关可用池内存类型的说明,请参阅 POOL_TYPE

可以通过将按位 OR 与POOL_COLD_ALLOCATION标志一起使用来修改 PoolType,以提示内核从可能快速分页的页面分配内存。 若要尽可能减少驻留池内存量,不应经常引用这些分配。 POOL_COLD_ALLOCATION标志仅供咨询,适用于 Windows XP 和更高版本的 Windows作系统。

b

要分配的字节数。

返回值

没有

言论

此例程用于内存的常规池分配。

如果 bNumberOfBytes) PAGE_SIZE或更高版本,则会分配页对齐的缓冲区。 PAGE_SIZE或更少内存分配不会跨越页边界。 小于PAGE_SIZE的内存分配不一定是页面对齐的,而是与 32 位系统中的 8 字节边界对齐,在 64 位系统中与 16 字节边界对齐。

请求非分页池 NumberOfBytes< PAGE_SIZE 的成功分配为调用方提供所请求的内存字节数。 如果 NumberOfBytes> PAGE_SIZE 分配请求成功,并且 NumberOfBytes 不是PAGE_SIZE的确切倍数,则分配中的最后一页包含不属于调用方分配的字节数。 如果可能,池分配器使用这些字节。 为了避免损坏属于其他内核模式组件的数据,驱动程序必须仅访问显式分配的存储地址。

如果 ExAllocatePool 返回 NULL,则调用方应返回 NTSTATUS 值STATUS_INSUFFICIENT_RESOURCES或延迟处理到另一个时间点。

ExAllocatePool 的调用方必须在 IRQL <= DISPATCH_LEVEL执行。 在 DISPATCH_LEVEL 执行的调用方必须为 PoolType指定 NonPagedXxx 值。 在 IRQL <= APC_LEVEL 执行的调用方可以指定任何POOL_TYPE值,但还必须考虑 IRQL 和环境来确定页面类型。

注意

不要 NumberOfBytes = 0 设置。 避免零长度分配,因为它们会浪费池标头空间,在许多情况下,指示调用代码中可能存在验证问题。 因此,驱动程序验证程序 标志,如可能的分配错误。

当池量(分页或非分页)为高或低时,系统会自动设置某些标准事件对象。 驱动程序可以等待这些事件来优化其池使用情况。 有关详细信息,请参阅 标准事件对象

注意

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

要求

要求 价值
最低支持的客户端 过时。 此例程仅针对现有二进制文件导出。 请改用 ExAllocatePoolWithTag。
目标平台 普遍
标头 classpnp.h (包括 Wdm.h、Ntddk.h、Ntifs.h、Classpnp.h、Smcnt.h)
NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL (请参阅“备注”部分)
DDI 符合性规则 CheckDeviceObjectFlags(wdm)HwStorPortProhibitedDDIs(storport)IrqlExAllocatePool(wdm)PowerDownAllocate(wdm)PowerUpFail(wdm)SpNoWait(storport)StorPortStartIo(storport)UnsafeAllocatePool(kmdf)UnsafeAllocatePool(wdm)

另请参阅

ExAllocatePoolWithTag

ExFreePool

POOL_TYPE