Estrutura MEMORYSTATUS (winbase.h)

Contém informações sobre o estado atual da memória física e virtual. A função GlobalMemoryStatus armazena informações em uma estrutura MEMORYSTATUS .

Sintaxe

typedef struct _MEMORYSTATUS {
  DWORD  dwLength;
  DWORD  dwMemoryLoad;
  SIZE_T dwTotalPhys;
  SIZE_T dwAvailPhys;
  SIZE_T dwTotalPageFile;
  SIZE_T dwAvailPageFile;
  SIZE_T dwTotalVirtual;
  SIZE_T dwAvailVirtual;
} MEMORYSTATUS, *LPMEMORYSTATUS;

Membros

dwLength

O tamanho da estrutura de dados MEMORYSTATUS , em bytes. Você não precisa definir esse membro antes de chamar a função GlobalMemoryStatus ; a função o define.

dwMemoryLoad

Um número entre 0 e 100 que especifica o percentual aproximado 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).

dwTotalPhys

A quantidade de memória física real, em bytes.

dwAvailPhys

A quantidade de memória física atualmente disponível, 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.

dwTotalPageFile

O tamanho atual do limite de memória confirmada, em bytes. Essa é a memória física mais o tamanho do arquivo de página, menos uma pequena sobrecarga.

dwAvailPageFile

A quantidade máxima de memória que o processo atual pode confirmar, em bytes. Esse valor deve ser menor do que o commit disponível em todo o sistema. Para calcular esse valor, chame GetPerformanceInfo e subtraia o valor de CommitTotal de CommitLimit.

dwTotalVirtual

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 GT RAM habilitado.

dwAvailVirtual

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.

Comentários

MEMORYSTATUS 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.

Em computadores com mais de 4 GB de memória, a estrutura MEMORYSTATUS pode retornar informações incorretas, relatando um valor de –1 para indicar um estouro. Se o aplicativo estiver em risco para esse comportamento, use a função GlobalMemoryStatusEx em vez da função GlobalMemoryStatus .

Exemplos

Para obter um exemplo, consulte a função GlobalMemoryStatus .

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	winbase.h (inclua Windows.h)

Confira também

Globalmemorystatus

GlobalMemoryStatusEx

Informações de desempenho de memória