Partager via


MmAllocateMappingAddress, fonction (wdm.h)

La routine MmAllocateMappingAddress réserve une plage d’espace d’adressage virtuel système de la taille spécifiée.

Syntaxe

PVOID MmAllocateMappingAddress(
  [in] SIZE_T NumberOfBytes,
  [in] ULONG  PoolTag
);

Paramètres

[in] NumberOfBytes

Spécifie le nombre d’octets à réserver.

[in] PoolTag

Spécifie une balise à quatre caractères utilisée pour identifier la mémoire tampon. Utilisez une balise PoolTag distincte pour chaque chemin d’accès au code d’allocation. Pour obtenir une description des balises de pool, consultez ExAllocatePoolWithTag.

Valeur de retour

MmAllocateMappingAddress retourne un pointeur au début de la mémoire tampon réservée.

Remarques

MmAllocateMappingAddress réserve une plage d’adresses virtuelles système que l’appelant doit utiliser. Aucune mémoire physique n’est allouée pour la plage d’adresses virtuelle et la mémoire virtuelle n’est pas accessible tant qu’elle n’est pas mappée par la routine MmMapLockedPagesWithReservedMapping. L’appelant annule le mappage de la plage de mémoire réservée en appelant la routine MmUnmapReservedMapping. Enfin, l’appelant peut libérer la plage réservée en appelant MmFreeMappingAddress.

Exigences

Exigence Valeur
client minimum pris en charge Disponible dans Windows XP et versions ultérieures de Windows.
plateforme cible Universel
d’en-tête wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <=APC_LEVEL

Voir aussi

mmFreeMappingAddress

MmMapLockedPagesWithReservedMapping

mmUnmapReservedMapping