ExAllocatePoolWithQuotaTag 函数 (wdm.h)

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

警告

ExAllocatePoolWithQuotaTag 已在 Windows 10 版本 2004 中弃用,已替换为 ExAllocatePool2。 有关详细信息,请参阅 更新对 ExAllocatePool2 和 ExAllocatePool3的已弃用 ExAllocatePool 调用。

语法

PVOID ExAllocatePoolWithQuotaTag(
  [in] __drv_strictTypeMatch(__drv_typeExpr)POOL_TYPE PoolType,
  [in] SIZE_T                                         NumberOfBytes,
  [in] ULONG                                          Tag
);

参数

[in] PoolType

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

可以使用POOL_QUOTA_FAIL_INSTEAD_OF_RAISE标志按位 ORing 此值来修改 PoolType 值。 如果无法满足请求,此标志会导致例程返回 NULL 值。

同样,可以通过按位 ORing 此值来修改 PoolType 值,并将POOL_COLD_ALLOCATION标志作为内核提示,以从可能快速分页的页面分配内存。 若要尽可能减少驻留池内存量,不应经常引用这些分配。 POOL_COLD_ALLOCATION标志仅提供公告,在 Windows XP 和更高版本的 Windows作系统中受支持。

[in] NumberOfBytes

指定要分配的字节数。

[in] Tag

指定已分配内存的池标记。 有关详细信息,请参阅 ExAllocatePoolWithTagTag 参数。

返回值

ExAllocatePoolWithQuotaTag 返回指向已分配池的指针。

如果无法满足请求,ExAllocatePoolWithQuotaTag 将引发异常,除非指定了POOL_QUOTA_FAIL_INSTEAD_OF_RAISE。 出于性能原因,首选使用POOL_QUOTA_FAIL_INSTEAD_OF_RAISE。

言论

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

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

系统将池标记与分配的内存相关联。 编程工具(如 WinDbg)可以显示与每个分配的缓冲区关联的池标记。 标记 的值通常以反向顺序显示。 例如,如果调用方将“Fred”作为 标记传递,则当池被转储或跟踪调试器中的池使用情况时,它将显示为“derF”。

可以使用 ExFreePoolExFreePoolWithTag释放分配的缓冲区。

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

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

在非统一内存访问(NUMA)多处理器体系结构中,ExAllocatePoolWithQuotaTag 尝试将本地内存分配给调用 ExAllocatePoolWithQuotaTag的处理器。 如果没有可用的本地内存,ExAllocatePoolWithQuotaTag 分配最近的可用内存。

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

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

要求

要求 价值
目标平台 普遍
标头 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL (请参阅“备注”部分)
DDI 符合性规则 HwStorPortProhibitedDIS(storport)SpNoWait(storport)StorPortStartIo(storport)UnsafeAllocatePool(kmdf)

另请参阅

ExAllocatePoolWithTag

ExFreePool

ExFreePoolWithTag

POOL_TYPE