Función ExAllocatePoolQuotaZero (wdm.h)

Precaución

Microsoft es consciente de un problema con ExAllocatePoolQuotaZero 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 ExAllocatePoolWithQuotaTag.

ExAllocatePoolQuotaZero asigna memoria de grupo del tipo especificado y devuelve un puntero al bloque asignado. Es idéntico a ExAllocatePoolWithQuotaTag , excepto que cero inicializa la memoria asignada. Si no se desea, use ExAllocatePoolQuotaUninitialized en su lugar.

Sintaxis

PVOID ExAllocatePoolQuotaZero(
  __drv_strictTypeMatch(__drv_typeExpr)POOL_TYPE PoolType,
  SIZE_T                                         NumberOfBytes,
  ULONG                                          Tag
);

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.

De forma similar, puede modificar el valor 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 es probable que se paginan 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 de 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.

Valor devuelto

ExAllocatePoolQuotaZero devuelve un puntero al grupo asignado.

Si no se puede satisfacer la solicitud, ExAllocatePoolQuotaZero genera una excepción a menos que se especifique POOL_QUOTA_FAIL_INSTEAD_OF_RAISE. Se prefiere usar POOL_QUOTA_FAIL_INSTEAD_OF_RAISE por motivos de rendimiento.

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.

Los controladores de nivel superior llaman a esta rutina que asignan memoria para satisfacer una solicitud en el contexto del proceso que originalmente realizó la solicitud de E/S. En su lugar, los controladores de nivel inferior llaman a ExAllocatePoolZero .

Consulte la sección Comentarios de ExAllocatePoolWithQuotaTag 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, SpNoWait, StorPortStartIo

Consulte también

ExAllocatePoolQuotaUninitialized