IHostMemoryManager::GetMemoryLoad, méthode
Obtient la quantité de mémoire physique actuellement utilisée et qui n'est par conséquent pas disponible, comme indiqué par l'hôte.
HRESULT GetMemoryLoad (
[out] DWORD* pMemoryLoad,
[out] SIZE_T *pAvailableBytes
);
Paramètres
pMemoryLoad
[out] Pointeur vers le pourcentage approximatif de mémoire physique totale qui est actuellement en cours d'utilisation.pAvailableBytes
[out] Pointeur vers le nombre d'octets disponibles pour le Common Language Runtime (CLR).
Valeur de retour
HRESULT |
Description |
|---|---|
S_OK |
GetMemoryLoad a été retourné avec succès. |
HOST_E_CLRNOTAVAILABLE |
Le CLR n'a pas été chargé dans un processus ou le CLR présente un état dans lequel il ne peut pas exécuter de code managé ou traiter l'appel avec succès. |
HOST_E_TIMEOUT |
L'appel a expiré. |
HOST_E_NOT_OWNER |
L'appelant ne possède pas le verrou. |
HOST_E_ABANDONED |
Un événement a été annulé alors qu'un thread bloqué ou une fibre l'attendait. |
E_FAIL |
Une défaillance grave et inconnue s'est produite. Lorsqu'une méthode retourne E_FAIL, le CLR n'est plus utilisable dans le processus. Les appels suivants aux méthodes d'hébergement retournent HOST_E_CLRNOTAVAILABLE. |
Notes
GetMemoryLoad encapsule la fonction GlobalMemoryStatus Win32. La valeur de pMemoryLoad est l'équivalent du champ dwMemoryLoad dans la structure MEMORYSTATUS retournée à partir de GlobalMemoryStatus.
Le runtime utilise la valeur de retour comme heuristique pour le garbage collector (également appelé ramasse-miettes). Par exemple, si l'hôte indique que la majorité de la mémoire est en cours d'utilisation, le garbage collector peut choisir d'effectuer une collecte à partir de plusieurs générations afin d'augmenter la quantité de mémoire qui peut devenir potentiellement disponible.
Configuration requise
Plateformes : consultez Configuration requise du .NET Framework.
En-tête : MSCorEE.h
Bibliothèque : incluse en tant que ressource dans MSCorEE.dll
Versions du .NET Framework : 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0