ExAllocatePoolPriorityUninitialized, fonction (wdm.h)

Cette routine est un wrapper et une option de remplacement pour ExAllocatePoolWithTagPriority.

ExAllocatePoolPriorityUninitialized alloue la mémoire du pool du type spécifié.

Syntaxe

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

Paramètres

PoolType

Type de mémoire de pool à allouer. Pour obtenir une description des types de mémoire de pool disponibles, consultez POOL_TYPE.

Vous pouvez modifier la valeur d’énumération en effectuant une opération OR au niveau du bit avec l’indicateur POOL_RAISE_IF_ALLOCATION_FAILURE défini dans wdm.h. Cet indicateur entraîne le déclenchement d’une exception si la demande ne peut pas être satisfaite. L’utilisation de cet indicateur n’est pas recommandée, car elle est coûteuse.

De même, vous pouvez modifier la valeur PoolType en oRingant cette valeur au niveau du bit avec l’indicateur POOL_COLD_ALLOCATION (également défini dans wdm.h) comme indicateur pour le noyau pour allouer la mémoire à partir de pages susceptibles d’être supprimées rapidement. Pour réduire autant que possible la quantité de mémoire du pool résident, vous ne devez pas référencer ces allocations fréquemment. L’indicateur POOL_COLD_ALLOCATION n’est qu’un avertissement.

NumberOfBytes

Nombre d'octets à allouer.

Tag

Balise de pool à utiliser pour la mémoire allouée. Pour plus d’informations, consultez le paramètre Tag d’ExAllocatePoolWithTag.

Priority

Valeur d’énumération EX_POOL_PRIORITY spécifiant la priorité de cette demande.

Valeur retournée

ExAllocatePoolPriorityUninitialized retourne null si la mémoire dans le pool libre est insuffisante pour répondre à la demande, sauf si POOL_RAISE_IF_ALLOCATION_FAILURE est spécifié. Sinon, la routine retourne un pointeur vers la mémoire allouée.

Remarques

La mémoire allouée par ExAllocatePoolPriorityUninitialized est non initialisée. Un pilote en mode noyau doit d’abord zéro cette mémoire s’il veut la rendre visible pour les logiciels en mode utilisateur (pour éviter la fuite de contenu potentiellement privilégié)

Pour obtenir des conseils supplémentaires, consultez la section Remarques de ExAllocatePoolWithTagPriority .

Configuration requise

Voir aussi

ExAllocatePoolWithTagPriority

ExAllocatePoolPriorityZero