Partilhar via


Método IHostMemoryManager::GetMemoryLoad

Obtém a quantidade de memória física que está atualmente em uso e, portanto, não disponível, sistema autônomo informado pelo host.

HRESULT GetMemoryLoad (
    [out] DWORD*  pMemoryLoad, 
    [out] SIZE_T  *pAvailableBytes
);

Parâmetros

  • pMemoryLoad
    [out] Um ponteiro para a porcentagem aproximada de memória física total que está em uso no momento.

  • pAvailableBytes
    [out] Um ponteiro para o número de bytes disponível para o Common linguagem tempo de execução (CLR).

Valor de retorno

HRESULT

Descrição

S_OK

GetMemoryLoad retornado com êxito.

HOST_E_CLRNOTAVAILABLE

O CLR não foi carregado em um processo ou o CLR está em um estado em que ele não possa executar código gerenciado ou processar a telefonar com êxito.

HOST_E_TIMEOUT

A telefonar expirou.

HOST_E_NOT_OWNER

O chamador não é proprietário do bloquear.

HOST_E_ABANDONED

Um evento foi cancelado enquanto um segmento bloqueado ou fibra estava aguardando nele.

E_FAIL

Ocorreu uma falha catastrófica desconhecida. Quando um método retorna E_FAIL, o CLR não é mais útil dentro do processo. As chamadas subseqüentes à hospedagem métodos retornam HOST_E_CLRNOTAVAILABLE.

Comentários

GetMemoryLoad quebra automática do Win32 GlobalMemoryStatus função. O valor de pMemoryLoad é o equivalente a dwMemoryLoad campo de MEMORYSTATUS retornado da estrutura GlobalMemoryStatus.

O tempo de execução usa o valor retornado sistema autônomo uma heurística para o coletor de lixo. Por exemplo, se o host informa que a maioria dos 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: See Requisitos de sistema do .NET framework.

Cabeçalho: MSCorEE.idl

Biblioteca: Incluído sistema autônomo um recurso em MSCorEE.dll

.NET Framework Versions: 3.5 SP1, 3,5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Consulte também

Referência

System.GC

Interface IHostMemoryManager