Função GlobalMemoryStatus (winbase.h)
[GlobalMemoryStatus pode retornar informações incorretas. Em vez disso, use a função GlobalMemoryStatusEx .]
Recupera informações sobre o uso atual do sistema de memória física e virtual.
Sintaxe
void GlobalMemoryStatus(
[out] LPMEMORYSTATUS lpBuffer
);
Parâmetros
[out] lpBuffer
Um ponteiro para uma estrutura MEMORYSTATUS . A função GlobalMemoryStatus armazena informações sobre a disponibilidade de memória atual nessa estrutura.
Retornar valor
Nenhum
Comentários
Em computadores com mais de 4 GB de memória, a função GlobalMemoryStatus pode retornar informações incorretas, relatando um valor de –1 para indicar um estouro. Por esse motivo, os aplicativos devem usar a função GlobalMemoryStatusEx .
Em computadores Intel x86 com mais de 2 GB e menos de 4 GB de memória, a função GlobalMemoryStatus sempre retornará 2 GB no membro dwTotalPhys da estrutura MEMORYSTATUS . Da mesma forma, se a memória total disponível estiver entre 2 e 4 GB, o membro dwAvailPhys da estrutura MEMORYSTATUS será arredondado para 2 GB. Se o executável estiver vinculado usando a opção do vinculador /LARGEADDRESSAWARE , a função GlobalMemoryStatus retornará a quantidade correta de memória física em ambos os membros.
As informações retornadas pela função GlobalMemoryStatus são voláteis. Não há nenhuma garantia de que duas chamadas sequenciais para essa função retornarão as mesmas informações.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | winbase.h (incluir Windows.h) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |
Confira também
Funções de gerenciamento da memória