Estrutura MEMORYSTATUSEX (sysinfoapi.h)
Contém informações sobre o estado atual da memória física e virtual, incluindo memória estendida. A função GlobalMemoryStatusEx armazena informações nessa estrutura.
Sintaxe
typedef struct _MEMORYSTATUSEX {
DWORD dwLength;
DWORD dwMemoryLoad;
DWORDLONG ullTotalPhys;
DWORDLONG ullAvailPhys;
DWORDLONG ullTotalPageFile;
DWORDLONG ullAvailPageFile;
DWORDLONG ullTotalVirtual;
DWORDLONG ullAvailVirtual;
DWORDLONG ullAvailExtendedVirtual;
} MEMORYSTATUSEX, *LPMEMORYSTATUSEX;
Membros
dwLength
O tamanho da estrutura em bytes. Você deve definir esse membro antes de chamar
GlobalMemoryStatusEx.
dwMemoryLoad
Um número entre 0 e 100 que especifica a porcentagem aproximada de memória física que está em uso (0 indica que não há uso de memória e 100 indica o uso de memória completa).
ullTotalPhys
A quantidade de memória física real, em bytes.
ullAvailPhys
A quantidade de memória física disponível no momento, em bytes. Essa é a quantidade de memória física que pode ser reutilizado imediatamente sem precisar gravar seu conteúdo no disco primeiro. É a soma do tamanho das listas em espera, gratuitas e zero.
ullTotalPageFile
O limite de memória confirmada atual para o sistema ou o processo atual, o que for menor, em bytes. Para obter o limite de memória confirmada em todo o sistema, chame GetPerformanceInfo.
ullAvailPageFile
A quantidade máxima de memória que o processo atual pode confirmar, em bytes. Esse valor é igual ou menor que o valor de confirmação disponível em todo o sistema. Para calcular o valor de confirmação disponível em todo o sistema, chame GetPerformanceInfo e subtraia o valor de CommitTotal do valor de CommitLimit.
ullTotalVirtual
O tamanho da parte do modo de usuário do espaço de endereço virtual do processo de chamada, em bytes. Esse valor depende do tipo de processo, do tipo de processador e da configuração do sistema operacional. Por exemplo, esse valor é de aproximadamente 2 GB para a maioria dos processos de 32 bits em um processador x86 e aproximadamente 3 GB para processos de 32 bits que têm reconhecimento de endereço grande em execução em um sistema com ajuste de 4 gigabytes habilitado.
ullAvailVirtual
A quantidade de memória não reservada e não confirmada atualmente na parte do modo de usuário do espaço de endereço virtual do processo de chamada, em bytes.
ullAvailExtendedVirtual
Reservado. Esse valor é sempre 0.
Comentários
MEMORYSTATUSEX reflete o estado da memória no momento da chamada. Ele também reflete o tamanho do arquivo de paginação nesse momento. O sistema operacional pode ampliar o arquivo de paginação até o tamanho máximo definido pelo administrador.
Os tamanhos de memória física retornados incluem a memória de todos os nós.
Exemplos
Para obter um exemplo, consulte a função GlobalMemoryStatusEx .
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] |
| Cabeçalho | sysinfoapi.h (inclua Windows.h) |