VirtualAlloc, 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.

Pour allouer de la mémoire dans l’espace d’adressage d’un autre processus, utilisez la fonction VirtualAllocEx.

Syntaxe

LPVOID VirtualAlloc(
  [in, optional] LPVOID lpAddress,
  [in]           SIZE_T dwSize,
  [in]           DWORD  flAllocationType,
  [in]           DWORD  flProtect
);

Paramètres

[in, optional] lpAddress

Adresse de départ de la région à allouer. Si la mémoire est réservée, l’adresse spécifiée est arrondie au multiple le plus proche de la granularité d’allocation. Si la mémoire est déjà réservée et est validée, l’adresse est arrondie à la limite de page suivante. Pour déterminer la taille d’une page et la granularité d’allocation sur l’ordinateur hôte, utilisez la fonction GetSystemInfo. Si ce paramètre est NULL, le système détermine où allouer la région.

Si cette adresse se trouve dans une enclave que vous n’avez pas initialisée en appelant InitializeEnclave, VirtualAlloc alloue une page de zéros pour l’enclave à cette adresse. La page doit être précédemment non validée et ne sera pas mesurée avec l’instruction EEXTEND du modèle de programmation Extensions Intel Software Guard.

Si l’adresse se trouve dans une enclave que vous avez initialisée, l’opération d’allocation échoue avec l’erreur ERROR_INVALID_ADDRESS. Cela est vrai pour les enclaves qui ne prennent pas en charge la gestion de la mémoire dynamique (par exemple SGX1). Les enclaves SGX2 autorisent l’allocation et la page doit être acceptée par l’enclave une fois qu’elle a été allouée.

[in] dwSize

Taille de la région, en octets. Si le paramètre lpAddress est NULL, cette valeur est arrondie à la limite de page suivante. Sinon, les pages allouées incluent toutes les pages contenant un ou plusieurs octets de la plage de lpAddress à lpAddress+dwSize. Cela signifie qu’une plage de 2 octets s’écartant d’une limite de page entraîne l’inclusion des deux pages dans la région allouée.

[in] flAllocationType

Type d’allocation de mémoire. Ce paramètre doit contenir l’une des valeurs suivantes.

Ce paramètre peut également spécifier les valeurs suivantes, comme indiqué.

[in] flProtect

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 .

Si lpAddress spécifie une adresse dans une enclave, flProtect ne peut pas être l’une des valeurs suivantes :

• PAGE_NOACCESS
• PAGE_GUARD
• PAGE_NOCACHE
• PAGE_WRITECOMBINE

Lors de l’allocation de mémoire dynamique pour une enclave, le paramètre flProtect doit être PAGE_READWRITE ou PAGE_EXECUTE_READWRITE.

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

Chaque page a un état de page associé. La fonction VirtualAlloc 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

virtualAlloc ne peut pas réserver une page réservée. Il peut valider une page déjà validée. Cela signifie que vous pouvez valider une plage de pages, qu’elles aient déjà été validées et que la fonction ne échoue pas.

Vous pouvez utiliser VirtualAlloc pour réserver un bloc de pages, puis effectuer des appels supplémentaires à VirtualAlloc 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 lpAddress n’est pas NULL, la fonction utilise les paramètres lpAddress et dwSize pour calculer la région des pages à allouer. L’état actuel de la plage entière de pages doit être compatible avec le type d’allocation spécifié par le paramètre flAllocationType. Sinon, la fonction échoue et aucune des pages n’est allouée. Cette exigence de compatibilité n’empêche pas la validation d’une page déjà validée, comme mentionné précédemment.

Pour exécuter du code généré dynamiquement, utilisez VirtualAlloc pour allouer de la mémoire et la fonction VirtualProtect pour accorder l’accès PAGE_EXECUTE.

La fonction VirtualAlloc peut être utilisée pour réserver une address windowing Extensions (AWE) région de mémoire au sein de 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 MEM_PHYSICAL et MEM_RESERVE doivent être définies dans le paramètre AllocationType . La valeur MEM_COMMIT ne doit pas être définie. La protection de page doit être définie sur PAGE_READWRITE.

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 un exemple, consultez réserver et valider la mémoire.

Exigences

Voir aussi

fonctions de gestion de la mémoire

fonctions de mémoire virtuelle

virtualAllocEx

VirtualFree

VirtualLock

VirtualProtect

virtualQuery

API Vertdll disponibles dans les enclaves VBS