Función ExAllocatePoolPriorityZero (wdm.h)
Precaución
Microsoft es consciente de un problema con ExAllocatePoolPriorityZero que puede provocar que una asignación no se 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 memoria de grupo del tipo especificado.
Es idéntico a ExAllocatePoolWithTagPriority , salvo que cero inicializa la memoria asignada. Si no se 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 una operación 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 PoolType mediante ORing bit a bit con la marca POOL_COLD_ALLOCATION (también definida en wdm.h) como una 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 de 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 delimitado 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 suficiente memoria 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.
Comentarios
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 | Value |
|---|---|
| Cliente mínimo compatible | Requiere WDK para Windows 10, versión 2004. Tiene como destino Windows 7 y versiones posteriores del sistema operativo Windows. |
| Plataforma de destino | Universal |
| Encabezado | wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL (consulte la sección Comentarios) |
| Reglas de cumplimiento de DDI | HwStorPortProhibitedDIs, IrqlExAllocatePool, IrqlExFree2, SpNoWait, StorPortStartIo |