IHostMemoryManager::VirtualFree, méthode

Article
05/10/2023

Sert de wrapper logique pour la fonction Win32 correspondante. L’implémentation Win32 de VirtualFree libère, décommite ou libère et décommite une région de pages dans l’espace d’adressage virtuel du processus appelant.

Syntaxe

HRESULT VirtualFree (  
    [in] LPVOID  lpAddress,  
    [in] SIZE_T  dwSize,  
    [in] DWORD   dwFreeType  
);

Paramètres

lpAddress
[in] Pointeur vers l’adresse de base des pages de mémoire virtuelle à libérer.

dwSize
[in] Taille, en octets, de la région à libérer.

dwFreeType
[in] Type d’opération de libération.

Valeur de retour

HRESULT	Description
S_OK	`VirtualFree` retourné.
HOST_E_CLRNOTAVAILABLE	Le Common Language Runtime (CLR) n’a pas été chargé dans un processus ou est dans un état dans lequel il ne peut ni exécuter le code managé ni traiter l’appel avec succès.
HOST_E_TIMEOUT	L’appel a expiré.
HOST_E_NOT_OWNER	L’appelant n’est pas propriétaire du verrou.
HOST_E_ABANDONED	Un événement a été annulé alors qu’un thread ou une fibre bloqué l’attendait.
E_FAIL	Une défaillance catastrophique inconnue s’est produite. Quand une méthode retourne E_FAIL, le CLR n’est plus utilisable au sein du processus. Les appels suivants aux méthodes d’hébergement retournent HOST_E_CLRNOTAVAILABLE.
HOST_E_INVALIDOPERATION	Une tentative a été effectuée pour libérer de la mémoire qui n’a pas été allouée par le biais de l’hôte.

Notes

VirtualFree libère les pages de mémoire virtuelle associées au paramètre lpAddress par le biais d’un appel antérieur à la fonction IHostMemoryManager::VirtualAlloc. Les tentatives de libération de la mémoire qui n’a pas été allouée par le biais de l’hôte doivent retourner HOST_E_INVALIDOPERATION.

La sémantique est identique à celle de l’implémentation Win32 de VirtualFree. Pour plus d’informations, consultez la documentation de la plateforme Windows.

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : MSCorEE.h

Bibliothèque : incluse en tant que ressource dans MsCorEE.dll

Versions de .NET Framework : Disponible depuis la version 2.0

Partager via