IHostMemoryManager::GetMemoryLoad, méthode
Obtient la quantité de mémoire physique en cours d’utilisation, et par conséquent indisponible, comme indiqué par l’hôte.
Syntaxe
HRESULT GetMemoryLoad (
[out] DWORD* pMemoryLoad,
[out] SIZE_T *pAvailableBytes
);
Paramètres
pMemoryLoad
[out] Pointeur vers le pourcentage approximatif de mémoire physique totale 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 retourné. |
| HOST_E_CLRNOTAVAILABLE | Le CLR n’a pas été chargé dans un processus ou son état ne lui permet pas d’exécuter du code managé ni de traiter l’appel correctement. |
| 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 renvoient HOST_E_CLRNOTAVAILABLE. |
Notes
GetMemoryLoad encapsule la fonction Win32 GlobalMemoryStatus. La valeur de pMemoryLoad est l’équivalent du champ dwMemoryLoad dans la structure MEMORYSTATUS retournée par GlobalMemoryStatus.
Le runtime utilise la valeur de retour comme heuristique pour le récupérateur de mémoire. Par exemple, si l’hôte signale que la majorité de la mémoire est en cours d’utilisation, le récupérateur de mémoire peut choisir de collecter à partir de plusieurs générations pour augmenter la quantité de mémoire potentiellement disponible.
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
