estructura POOL_CREATE_EXTENDED_PARAMS (wdm.h)

Define la estructura POOL_CREATE_EXTENDED_PARAMS .

Sintaxis

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

Miembros

Version

ULONG que especifica la versión de esta estructura. Establézcalo en POOL_CREATE_PARAMS_VERSION (actualmente 1). Cualquier otro valor hace que ExCreatePool produzca un error con STATUS_INVALID_PARAMETER. Las versiones futuras pueden ampliar esta estructura; los controladores siempre deben inicializar este campo explícitamente.

ParameterCount

Número de elementos de la matriz a los que apunta Parameters. Debe ser 0 si no se proporciona ningún parámetro extendido.

Parameters

Puntero a una matriz de POOL_CREATE_EXTENDED_PARAMETER entradas que proporcionan parámetros de creación adicionales. Debe ser NULL cuando ParameterCount es 0. El campo Tipo de cada entrada identifica el tipo de parámetro. Actualmente, el único tipo válido es PoolCreateExtendedParameterName, que proporciona el nombre Unicode del grupo en el miembro PoolName . El nombre debe ser único dentro del contexto del controlador de creación y seguir las restricciones de nomenclatura internas. Se rechazan los tipos de parámetros no admitidos o duplicados.

Observaciones

Use esta estructura para pasar datos de creación extendidos opcionales (o obligatorios) a ExCreatePool a través de su argumento Params .

Los grupos privados paginados y no paginados deben especificar exactamente un parámetro de nombre. Los grupos seguros no deben especificar un parámetro de nombre.

Si ParameterCount no es cero, los parámetros deben apuntar a una matriz válida legible de esas muchas entradas.

Los tipos de parámetro no reconocidos por el kernel o que aparecen más de una vez hacen que ExCreatePool devuelva STATUS_INVALID_PARAMETER_3.

La estructura tiene versiones para permitir la compatibilidad directa; los controladores no deben suponer que los campos adicionales permanecen cero en futuras versiones: compruebe siempre la versión antes de interpretar extensiones no reconocidas (si se lee un búfer originado en otro lugar).

Requisitos

Consulte también

ExCreatePool

ExDestroyPool