POOL_CREATE_EXTENDED_PARAMS结构 （wdm.h）

定义 POOL_CREATE_EXTENDED_PARAMS 结构。

语法

typedef struct _POOL_CREATE_EXTENDED_PARAMS {
  ULONG                           Version;
  ULONG                           ParameterCount;
  PPOOL_CREATE_EXTENDED_PARAMETER Parameters;
} POOL_CREATE_EXTENDED_PARAMS, *PPOOL_CREATE_EXTENDED_PARAMS;

成员

Version

指定此结构的版本的 ULONG。 设置为 POOL_CREATE_PARAMS_VERSION （当前为 1）。 任何其他值都会导致 ExCreatePool 失败并出现 STATUS_INVALID_PARAMETER。 将来的版本可能会扩展此结构;驱动程序必须始终显式初始化此字段。

ParameterCount

参数指向的数组中的元素数。 如果未提供任何扩展参数，则必须为 0。

Parameters

指向提供其他创建参数 的POOL_CREATE_EXTENDED_PARAMETER 项数组的指针。 ParameterCount 为 0 时必须为 NULL。 每个条目的 “类型” 字段标识参数类型。 目前唯一有效的类型是 PoolCreateExtendedParameterName，该名称在 PoolName 成员中提供池的 Unicode 名称。 名称在创建驱动程序上下文中必须唯一，并遵循任何内部命名约束。 不支持或重复的参数类型被拒绝。

注解

使用此结构通过 Params 参数将可选（或必需）扩展的创建数据传递给 ExCreatePool。

分页和非分页专用池必须精确指定一个名称参数。 安全池不得指定名称参数。

如果 ParameterCount 为非零， 则参数 必须指向该多个条目的有效可读数组。

内核无法识别的参数类型或多次出现会导致 ExCreatePool 返回 STATUS_INVALID_PARAMETER_3。

该结构经过版本控制以允许向前兼容性;驱动程序不应假定将来的版本中其他字段保持不变，始终在解释无法识别的扩展之前检查版本（如果读取来自其他位置的缓冲区）。

要求

另请参阅

ExCreatePool

ExDestroyPool