Función ExAllocatePoolPriorityZero (wdm.h)

Precaución

Microsoft es consciente de un problema con ExAllocatePoolPriorityZero que puede provocar que una asignación no se asignación se a cero en Windows 10, versión 1909. Este problema se ha corregido en una actualización de seguridad del WDK para Windows 10, versión 2004 y Enterprise WDK (EWDK) para Windows 10, versión 2004 el 16 de diciembre de 2020. Para obtener información sobre cómo descargar el WDK más reciente, consulta Descargar el Kit de controladores de Windows (WDK).

Esta rutina es un contenedor para y una opción de reemplazo recomendada para ExAllocatePoolWithTagPriority.

ExAllocatePoolPriorityZero asigna la memoria del grupo del tipo especificado.

Es idéntico a ExAllocatePoolWithTagPriority excepto que cero inicializa la memoria asignada. Si no lo desea, use exAllocatePoolPriorityUninitialized en su lugar.

Sintaxis

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

Parámetros

PoolType

Tipo de memoria del grupo que se va a asignar. Para obtener una descripción de los tipos de memoria del grupo disponibles, consulte POOL_TYPE.

Puede modificar el valor de enumeración realizando un or bit a bit con la marca POOL_RAISE_IF_ALLOCATION_FAILURE definida en wdm.h. Esta marca hace que se genere una excepción si no se puede satisfacer la solicitud. No se recomienda el uso de esta marca porque es costoso.

Del mismo modo, puede modificar el valor de PoolType mediante ORing bit a bit con la marca POOL_COLD_ALLOCATION (también definida en wdm.h) como sugerencia al kernel para asignar la memoria de las páginas que probablemente se van a paginar rápidamente. Para reducir la cantidad de memoria del grupo residente tanto como sea posible, no debe hacer referencia a estas asignaciones con frecuencia. La marca POOL_COLD_ALLOCATION solo es aviso.

NumberOfBytes

Número de bytes que se van a asignar.

Tag

Etiqueta de grupo que se va a usar para la memoria asignada. Especifique la etiqueta de grupo como un literal de carácter distinto de cero de uno a cuatro caracteres delimitados por comillas simples (por ejemplo, Tag1). Normalmente, la cadena se especifica en orden inverso (por ejemplo, 1gaT). Cada carácter ASCII de la etiqueta debe ser un valor del intervalo 0x20 (espacio) para 0x7E (tilde). Cada ruta de acceso de código de asignación debe usar una etiqueta de grupo única para ayudar a los depuradores y comprobadores a identificar la ruta de acceso del código.

Priority

Valor de enumeración EX_POOL_PRIORITY que especifica la prioridad de esta solicitud.

Valor devuelto

ExAllocatePoolPriorityZero devuelve NULL si no hay memoria suficiente en el grupo libre para satisfacer la solicitud a menos que se especifique POOL_RAISE_IF_ALLOCATION_FAILURE. De lo contrario, la rutina devuelve un puntero a la memoria asignada.

Observaciones

Para ejecutarse en versiones de Windows anteriores a Windows 10 versión 2004, el controlador debe definir POOL_ZERO_DOWN_LEVEL_SUPPORT y llamar a ExInitializeDriverRuntime antes de llamar a esta función.

Consulte la sección Comentarios de exAllocatePoolWithTagPriority para obtener instrucciones adicionales.

Requisitos

Requisito Valor
cliente mínimo admitido Requiere WDK para Windows 10, versión 2004. Tiene como destino Windows 7 y versiones posteriores del sistema operativo Windows.
de la plataforma de destino de Universal
encabezado de wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
biblioteca de NtosKrnl.lib
DLL de NtosKrnl.exe
irQL <= DISPATCH_LEVEL (consulte la sección Comentarios)
reglas de cumplimiento de DDI HwStorPortProhibitedDIs, IrqlExAllocatePool, IrqlExFree2, SpNoWait, StorPortStartIo

Consulte también

ExAllocatePoolWithTagPriority

ExAllocatePoolPriorityUninitialized