Compartilhar via


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)

Confira também

GlobalMemoryStatusEx

Informações de desempenho de memória