Partager via

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

Voir aussi

  • Last updated on