ExAllocatePoolPriorityZero 函数 （wdm.h）

此例程是 ExAllocatePoolWithTagPriority的包装器和建议的替换选项。

ExAllocatePoolPriorityZero 分配指定类型的池内存。

它与 ExAllocatePoolWithTagPriority 相同，只不过零初始化分配的内存。 如果不需要，请改用 ExAllocatePoolPriorityUninitialized。

语法

PVOID ExAllocatePoolPriorityZero(
  __drv_strictTypeMatch(__drv_typeExpr)POOL_TYPE PoolType,
  SIZE_T                                         NumberOfBytes,
  ULONG                                          Tag,
  EX_POOL_PRIORITY                               Priority
);

参数

PoolType

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

可以通过使用 wdm.h中定义的POOL_RAISE_IF_ALLOCATION_FAILURE标志执行按位 OR 来修改枚举值。 如果无法满足请求，则此标志会导致引发异常。 不建议使用此标志，因为它成本高昂。

同样，可以通过按位 ORing 此值来修改 PoolType 值，并将此值与POOL_COLD_ALLOCATION标志（在 wdm.h中定义）作为提示，提示内核从可能快速分页的页面分配内存。 若要尽可能减少驻留池内存量，不应经常引用这些分配。 POOL_COLD_ALLOCATION标志只是公告。

NumberOfBytes

要分配的字节数。

Tag

要用于已分配内存的池标记。 将池标记指定为一到四个字符的非零字符文本，用单引号分隔（例如，Tag1）。 字符串通常按反向顺序指定（例如，1gaT）。 标记中的每个 ASCII 字符都必须是区域0x20（空格）中的值才能0x7E（波形符）。 每个分配代码路径都应使用唯一的池标记来帮助调试器和验证程序标识代码路径。

Priority

指定此请求优先级的 EX_POOL_PRIORITY 枚举值。

返回值

如果可用池中的内存不足，除非指定了POOL_RAISE_IF_ALLOCATION_FAILURE，否则 ExAllocatePoolPriorityZero 将返回 NULL。 否则，例程将返回指向已分配内存的指针。

言论

若要在 Windows 10 版本 2004 之前的 Windows 版本上运行，驱动程序必须在调用此函数之前定义POOL_ZERO_DOWN_LEVEL_SUPPORT并调用 ExInitializeDriverRuntime。

有关其他指南，请参阅 ExAllocatePoolWithTagPriority 的“备注”部分。

要求

另请参阅

ExAllocatePoolWithTagPriority

ExAllocatePoolPriorityUninitialized