FsRtlAllocateAePushLock, fonction (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 du pool à allouer pour le verrou 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 par bitwise-ORing avec l’indicateur de POOL_RAISE_IF_ALLOCATION_FAILURE. Cet indicateur provoque la levée 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 en tant que littéral de caractère différent de zéro d’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 de retour
FsRtlAllocateAePushLock retourne NULL s’il n’y a pas de mémoire dans le pool libre pour satisfaire la requête. Sinon, la routine retourne un pointeur vers le verrou push alloué et initialisé.
Remarques
FsRtlAllocateAePushLock est utilisé pour allouer de la mémoire du pool pour un verrou push de développement automatique. Consultez FSRTL_ADVANCED_FCB_HEADER pour plus d’informations sur les verrous push de développement automatique.
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 l’allocation de pool spécial pour une balise de pool spécifique. 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énements 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 standard Event Objects.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 10, version 20H2 |
| d’en-tête | ntifs.h |
| IRQL | <= APC_LEVEL |