Método de IHostMemoryManager::GetMemoryLoad
Obtém a quantidade de memória física que está atualmente em uso e, portanto, não está disponível, como reportado pelo host.
HRESULT GetMemoryLoad (
[out] DWORD* pMemoryLoad,
[out] SIZE_T *pAvailableBytes
);
Parâmetros
pMemoryLoad
[out] Um ponteiro para a porcentagem aproximada da memória física total que está atualmente em uso.pAvailableBytes
[out] Um ponteiro para o número de bytes disponíveis para o common language runtime (CLR).
Valor de retorno
HRESULT |
Descrição |
|---|---|
S_OK |
GetMemoryLoadretornado com êxito. |
HOST_E_CLRNOTAVAILABLE |
O CLR não foi carregado em um processo ou o CLR é em um estado em que ele não é possível executar código gerenciado ou processar a chamada com êxito. |
HOST_E_TIMEOUT |
A chamada foi esgotado. |
HOST_E_NOT_OWNER |
O chamador não possui o bloqueio. |
HOST_E_ABANDONED |
Um evento foi cancelado, enquanto um segmento bloqueado ou fibra estava esperando por ele. |
E_FAIL |
Ocorreu uma falha catastrófica desconhecida. Quando um método retorna E_FAIL, o CLR não é usável dentro do processo. As chamadas subseqüentes para hospedar os métodos retornam HOST_E_CLRNOTAVAILABLE. |
Comentários
GetMemoryLoadencapsula o Win32 GlobalMemoryStatus função. O valor de pMemoryLoad é equivalente a dwMemoryLoad campo o MEMORYSTATUS retornado de estrutura de GlobalMemoryStatus.
O runtime usa o valor de retorno como uma heurística para o coletor de lixo. Por exemplo, se o host relata que a maioria da memória está em uso, o coletor de lixo pode optar por coletar de várias gerações para aumentar a quantidade de memória que potencialmente pode se tornar disponível.
Requisitos
Plataformas: Consulte Requisitos de sistema do .NET Framework.
Cabeçalho: MSCorEE.h
Biblioteca: Incluído como um recurso em mscoree
.NET Framework versões: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0