ExAllocatePoolWithQuota 宏 (classpnp.h)

ExAllocatePoolWithQuota 例程已过时,仅针对现有驱动程序二进制文件导出。 请改用 ExAllocatePoolWithQuotaTag

ExAllocatePoolWithQuota 分配池内存,针对当前进程收取配额。

语法

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

参数

a

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

可以使用 带POOL_COLD_ALLOCATION标志 的按位 OR 作为内核的提示来修改 (PoolType) ,以便从可能快速分页的页面中分配内存。 若要尽可能减少驻留池内存量,不应频繁引用这些分配。 POOL_COLD_ALLOCATION标志仅为公告,可用于 Windows XP 和 Windows 操作系统的更高版本。

b

指定要分配的字节数。

返回值

备注

此例程由分配内存以满足最初发出 I/O 请求的进程上下文中的请求的最高级别驱动程序调用。 较低级别的驱动程序改为调用 ExAllocatePoolWithTag

如果 b (NumberOfBytes) PAGE_SIZE或更大,则分配页对齐缓冲区。 配额 向分配PAGE_SIZE或更高版本的过程收费。

小于 PAGE_SIZE 的内存分配在页中分配,不会跨越页边界。 PAGE_SIZE 或更少的内存分配不一定是页面对齐的,而是与 32 位系统中的 8 字节边界和 64 位系统中的 16 字节边界对齐。

注意

请勿设置 NumberOfBytes = 0。 避免零长度分配,因为它们会浪费池标头空间,并且在许多情况下,指示调用代码中存在潜在的验证问题。 出于此原因, 驱动程序验证程序 将此类分配标记为可能的错误。

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

注意

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

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

要求

要求
最低受支持的客户端 已过时。 此例程仅针对现有驱动程序二进制文件导出。 请改用 ExAllocatePoolWithQuotaTag。
目标平台 通用
标头 classpnp.h (包括 Wdm.h、Ntddk.h、Ntifs.h、Classpnp.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL (请参阅备注部分)
DDI 符合性规则 HwStorPortProhibitedDDI (storport) SpNoWait (storport) StorPortStartIo (storport) UnsafeAllocatePool (kmdf)

另请参阅

ExAllocatePoolWithTag

ExAllocatePoolWithQuotaTag

ExFreePool

POOL_TYPE