Fonction FsRtlAllocateAePushLock (ntifs.h)

FsRtlAllocateAePushLock alloue et initialise un verrou push de développement automatique.

Syntaxe

PVOID FsRtlAllocateAePushLock(
  [in] POOL_TYPE PoolType,
  [in] ULONG     Tag
);

Paramètres

[in] PoolType

Type de mémoire de pool à allouer pour le verrouillage push de développement automatique. Consultez POOL_TYPE pour obtenir une description des types de mémoire de pool disponibles. Vous pouvez modifier la valeur PoolType en l’oring au niveau du bit avec l’indicateur POOL_RAISE_IF_ALLOCATION_FAILURE. Cet indicateur entraîne le déclenchement d’une exception si la demande d’allocation ne peut pas être satisfaite.

[in] Tag

Balise de pool à utiliser pour la mémoire allouée. Spécifiez la balise de pool sous la forme d’un littéral de caractères non nul de un à quatre caractères délimités par des guillemets simples (par exemple, « Tag1 »). La chaîne est généralement spécifiée dans l’ordre inverse (par exemple, « 1gaT »). Chaque caractère ASCII de la balise doit être une valeur dans la plage 0x20 (espace) à 0x7E (tilde). Chaque chemin de code d’allocation doit utiliser une balise de pool unique pour aider les débogueurs et les vérificateurs à identifier le chemin du code.

Valeur retournée

FsRtlAllocateAePushLock retourne la valeur NULL si la mémoire dans le pool libre est insuffisante pour répondre à la demande. Sinon, la routine retourne un pointeur vers le verrou push de développement automatique alloué et initialisé.

Remarques

FsRtlAllocateAePushLock est utilisé pour allouer de la mémoire du pool pour un verrou push de développement automatique. Pour plus d’informations sur les verrous Push de développement automatique, consultez FSRTL_ADVANCED_FCB_HEADER.

Le système associe la balise de pool à la mémoire allouée. Les outils de programmation, tels que WinDbg, peuvent afficher la balise de pool associée à chaque mémoire tampon allouée. Gflags, un outil inclus dans Outils de débogage pour Windows, active une fonctionnalité système qui demande une allocation à partir d’un pool spécial pour une balise de pool particulière. Poolmon, qui est inclus dans le WDK, effectue le suivi de la mémoire par balise de pool.

L’appelant de FsRtlAllocateAePushLock doit ensuite appeler FsRtlFreeAePushLock pour libérer le verrou push de développement automatique alloué.

Le système définit automatiquement certains objets d’événement standard lorsque la quantité de pool (paginée ou non paginée) est élevée ou faible. Les pilotes peuvent attendre que ces événements ajustent l’utilisation de leur pool. Pour plus d’informations, consultez Objets d’événements standard.

Configuration requise

Voir aussi

FSRTL_ADVANCED_FCB_HEADER

FsRtlFreeAePushLock

FsRtlSetupAdvancedHeaderEx2