VirtualAlloc2FromApp, fonction (memoryapi.h)
Réserve, valide ou modifie l’état d’une région de pages dans l’espace d’adressage virtuel du processus appelant. La mémoire allouée par cette fonction est automatiquement initialisée à zéro.
À l’aide de cette fonction, vous pouvez : pour les nouvelles allocations, spécifier une plage d’espace d’adressage virtuel et une restriction d’alignement power-of-2 ; spécifier un nombre arbitraire de paramètres étendus ; spécifiez un nœud NUMA préféré pour la mémoire physique en tant que paramètre étendu ; et spécifiez une opération d’espace réservé (en particulier, remplacement).
Pour spécifier le nœud NUMA, consultez le paramètre ExtendedParameters.
Syntaxe
PVOID VirtualAlloc2FromApp(
[in, optional] HANDLE Process,
[in, optional] PVOID BaseAddress,
[in] SIZE_T Size,
[in] ULONG AllocationType,
[in] ULONG PageProtection,
[in, out, optional] MEM_EXTENDED_PARAMETER *ExtendedParameters,
[in] ULONG ParameterCount
);
Paramètres
[in, optional] Process
Handle vers un processus. La fonction alloue de la mémoire dans l’espace d’adressage virtuel de ce processus.
Le handle doit disposer du droit d’accès PROCESS_VM_OPERATION. Pour plus d’informations, consultez Processus de sécurité et de droits d’accès.
[in, optional] BaseAddress
Pointeur qui spécifie une adresse de départ souhaitée pour la région des pages que vous souhaitez allouer.
Si baseAddress est NULL, la fonction détermine où allouer la région.
Si baseAddress n’est pas NULL, toute structure MEM_ADDRESS_REQUIREMENTS fournie doit être constituée de tous les zéros, et l’adresse de base doit être un multiple de la granularité d’allocation du système. Pour déterminer la granularité d’allocation, utilisez la fonction GetSystemInfo.
[in] Size
Taille de la région de mémoire à allouer, en octets.
La taille doit toujours être un multiple de la taille de page.
Si baseAddress n’est pas NULL, la fonction alloue toutes les pages qui contiennent un ou plusieurs octets de la plage de BaseAddress à +Size. Cela signifie, par exemple, qu’une plage de 2 octets qui chevauche une limite de page entraîne l’allocation des deux pages par fonction.
[in] AllocationType
Type d’allocation de mémoire. Ce paramètre doit contenir l’une des valeurs suivantes.
| Valeur | Signification |
|---|---|
|
Alloue des frais de mémoire (à partir de la taille globale de la mémoire et des fichiers de pagination sur le disque) pour les pages de mémoire réservée spécifiées. La fonction garantit également que lorsque l’appelant accède ultérieurement à la mémoire, le contenu sera égal à zéro. Les pages physiques réelles ne sont pas allouées, sauf si/tant que les adresses virtuelles ne sont pas réellement accessibles.
Pour réserver et valider des pages en une seule étape, appelez Virtual2AllocFromApp avec La tentative de validation d’une plage d’adresses spécifique en spécifiant MEM_COMMIT sans MEM_RESERVE et unNULLBaseAddress échoue, sauf si la plage entière a déjà été réservée. Le code d’erreur résultant est ERROR_INVALID_ADDRESS. Une tentative de validation d’une page déjà validée n’entraîne pas l’échec de la fonction. Cela signifie que vous pouvez valider des pages sans d’abord déterminer l’état d’engagement actuel de chaque page. |
|
Réserve une plage d’espace d’adressage virtuel du processus sans allouer de stockage physique réel en mémoire ou dans le fichier de pagination sur le disque.
Vous pouvez valider les pages réservées dans les appels suivants à la fonction Virtual2AllocFromApp. Pour réserver et valider des pages en une seule étape, appelez Virtual2AllocFromApp avec MEM_COMMIT | MEM_RESERVE. D’autres fonctions d’allocation de mémoire, telles que malloc et LocalAlloc, ne peuvent pas utiliser une plage réservée de mémoire tant qu’elle n’est pas libérée. |
|
Remplace un espace réservé par une allocation privée normale. Seules les vues de sections de données/pf-backed sont prises en charge (aucune image, mémoire physique, etc.). Lorsque vous remplacez un espace réservé, BaseAddress et Taille doit correspondre exactement à celles de l’espace réservé, et toute structure MEM_ADDRESS_REQUIREMENTS fournie doit se composer de tous les zéros.
Après avoir remplacé un espace réservé par une allocation privée, pour libérer cette allocation vers un espace réservé, consultez le paramètre dwFreeType de VirtualFree et VirtualFreeEx. Un espace réservé est un type de région de mémoire réservée. |
|
Pour créer un espace réservé, appelez VirtualAlloc2 avec MEM_RESERVE | MEM_RESERVE_PLACEHOLDER et PageProtection défini sur PAGE_NOACCESS. Pour libérer/fractionner/fusionner un espace réservé, consultez le paramètre dwFreeType de VirtualFree et VirtualFreeEx.
Un espace réservé est un type de région de mémoire réservée. |
|
Indique que les données de la plage de mémoire spécifiées par BaseAddress et Taille n’est plus intéressante. Les pages ne doivent pas être lues ou écrites dans le fichier de pagination. Toutefois, le bloc de mémoire sera utilisé à nouveau ultérieurement, de sorte qu’il ne doit pas être omis. Cette valeur ne peut pas être utilisée avec une autre valeur.
L’utilisation de cette valeur ne garantit pas que la plage utilisée avec MEM_RESET contiendra des zéros. Si vous souhaitez que la plage contienne des zéros, supprimez la mémoire, puis recommencez-la. Lorsque vous spécifiez MEM_RESET, la fonction Virtual2AllocFromApp ignore la valeur de Protection. Toutefois, vous devez toujours définir Protection sur une valeur de protection valide, telle que PAGE_NOACCESS. Virtual2AllocFromApp renvoie une erreur si vous utilisez MEM_RESET et que la plage de mémoire est mappée à un fichier. Une vue partagée est acceptable uniquement si elle est mappée à un fichier de pagination. |
|
MEM_RESET_UNDO ne doit être appelé que sur une plage d’adresses à laquelle MEM_RESET a été appliquée précédemment. Il indique que les données de la plage de mémoire spécifiée par BaseAddress et Taille intéressent l’appelant et tentent d’inverser les effets de MEM_RESET. Si la fonction réussit, cela signifie que toutes les données de la plage d’adresses spécifiée sont intactes. Si la fonction échoue, au moins certaines données de la plage d’adresses ont été remplacées par des zéros.
Cette valeur ne peut pas être utilisée avec une autre valeur. Si MEM_RESET_UNDO est appelée sur une plage d’adresses qui n’était pas MEM_RESET précédemment, le comportement n’est pas défini. Lorsque vous spécifiez MEM_RESET, la fonction Virtual2AllocFromApp ignore la valeur de Protection. Toutefois, vous devez toujours définir Protection sur une valeur de protection valide, telle que PAGE_NOACCESS. |
Ce paramètre peut également spécifier les valeurs suivantes, comme indiqué.
| Valeur | Signification |
|---|---|
|
Alloue de la mémoire à l’aide de prise en charge des grandes pages.
La taille et l’alignement doivent être un multiple du minimum de grande page. Pour obtenir cette valeur, utilisez la fonction GetLargePageMinimum. Si vous spécifiez cette valeur, vous devez également spécifier MEM_RESERVE et MEM_COMMIT. |
|
Réserve une plage d’adresses qui peut être utilisée pour mapper pages AWE (Address Windowing Extensions).
Cette valeur doit être utilisée avec MEM_RESERVE et aucune autre valeur. |
|
Alloue de la mémoire à l’adresse la plus élevée possible. Cela peut être plus lent que les allocations régulières, en particulier lorsqu’il existe de nombreuses allocations. |
|
Provoque le suivi des pages écrites dans la région allouée par le système. Si vous spécifiez cette valeur, vous devez également spécifier MEM_RESERVE.
Pour récupérer les adresses des pages qui ont été écrites depuis l’allocation de la région ou l’état de suivi de l’écriture a été réinitialisé, appelez la fonction GetWriteWatch. Pour réinitialiser l’état de suivi d’écriture, appelez GetWriteWatch ou ResetWriteWatch. La fonctionnalité de suivi de l’écriture reste activée pour la région de mémoire jusqu’à ce que la région soit libérée. |
[in] PageProtection
Protection de la mémoire pour la région des pages à allouer. Si les pages sont validées, vous pouvez spécifier l’une des constantes de protection de la mémoire . Les constantes suivantes génèrent une erreur :
- PAGE_EXECUTE
- PAGE_EXECUTE_READ
- PAGE_EXECUTE_READWRITE
- PAGE_EXECUTE_WRITECOPY
[in, out, optional] ExtendedParameters
Pointeur facultatif vers un ou plusieurs paramètres étendus de type MEM_EXTENDED_PARAMETER. Chacune de ces valeurs de paramètre étendues peut elle-même avoir un champ Type de MemExtendedParameterAddressRequirements ou MemExtendedParameterNumaNode. Si aucun paramètre étendu MemExtendedParameterNumaNode est fourni, le comportement est le même que pour les fonctions VirtualAlloc/MapViewOfFile (autrement dit, le nœud NUMA préféré pour les pages physiques est déterminé en fonction du processeur idéal du thread qui accède d’abord à la mémoire).
[in] ParameterCount
Nombre de paramètres étendus pointés par ExtendedParameters.
Valeur de retour
Si la fonction réussit, la valeur de retour est l’adresse de base de la région allouée de pages.
Si la fonction échoue, la valeur de retour est NULL . Pour obtenir des informations d’erreur étendues, appelez GetLastError.
Remarques
Cette API permet de prendre en charge des jeux hautes performances et des applications serveur, qui ont des exigences particulières concernant la gestion de leur espace d’adressage virtuel. Par exemple, mapper la mémoire au-dessus d’une région précédemment réservée ; cela est utile pour implémenter une mémoire tampon d’anneau d’habillage automatique. Et l’allocation de mémoire avec un alignement spécifique ; par exemple, pour permettre à votre application de valider de grandes régions mappées à la page à la demande.
Vous pouvez appeler Virtual2AllocFromApp à partir d’applications du Windows Store avec des fonctionnalités juste-à-temps (JIT) pour utiliser les fonctionnalités JIT. L’application doit inclure la fonctionnalité codeGeneration dans le fichier manifeste de l’application pour utiliser les fonctionnalités JIT.
Chaque page a un état de page associé. La fonction Virtual2AllocFromApp peut effectuer les opérations suivantes :
- Valider une région de pages réservées
- Réserver une région de pages gratuites
- Réserver et valider simultanément une région de pages libres
Vous pouvez utiliser Virtual2AllocFromApp pour réserver un bloc de pages, puis effectuer des appels supplémentaires à Virtual2AllocFromApp pour valider des pages individuelles à partir du bloc réservé. Cela permet à un processus de réserver une plage de son espace d’adressage virtuel sans consommer de stockage physique jusqu’à ce qu’il soit nécessaire.
Si le paramètre BaseAddress
Virtual2AllocFromApp n’autorise pas la création de pages exécutables.
La fonction Virtual2AllocFromApp peut être utilisée pour réserver une région Address Windowing Extensions (AWE) de mémoire dans l’espace d’adressage virtuel d’un processus spécifié. Cette région de mémoire peut ensuite être utilisée pour mapper des pages physiques dans et hors mémoire virtuelle, selon les besoins de l’application. Les valeurs
La fonction VirtualFree peut décommit une page validée, libérer le stockage de la page ou libérer simultanément une page validée. Il peut également libérer une page réservée, ce qui en fait une page gratuite.
Lors de la création d’une région qui sera exécutable, le programme appelant a la responsabilité de garantir la cohérence du cache via un appel approprié à FlushInstructionCache une fois le code en place. Sinon, les tentatives d’exécution de code hors de la région nouvellement exécutable peuvent produire des résultats imprévisibles.
Exemples
Pour obtenir des exemples de code, consultez Virtual2Alloc.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 10 [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows Server 2016 [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | memoryapi.h (include Windows.h) |
| bibliothèque | WindowsApp.lib |
| DLL | Kernel32.dll |
Voir aussi
fonctions de gestion de la mémoire