Função GetPhysicallyInstalledSystemMemory (sysinfoapi.h)

Recupera a quantidade de RAM instalada fisicamente no computador.

Sintaxe

BOOL GetPhysicallyInstalledSystemMemory(
  [out] PULONGLONG TotalMemoryInKilobytes
);

Parâmetros

[out] TotalMemoryInKilobytes

Um ponteiro para uma variável que recebe a quantidade de RAM instalada fisicamente, em quilobytes.

Retornar valor

Se a função for bem-sucedida, ela retornará TRUE e definirá o parâmetro TotalMemoryInKilobytes como um valor diferente de zero.

Se a função falhar, ela retornará FALSE e não modificará o parâmetro TotalMemoryInKilobytes . Para obter informações de erro estendidas, use a função GetLastError . Erros comuns são listados na tabela a seguir.

Comentários

A função GetPhysicallyInstalledSystemMemory recupera a quantidade de RAM fisicamente instalada das tabelas de firmware SMBIOS do computador. Isso pode ser diferente da quantidade relatada pela função GlobalMemoryStatusEx , que define o membro ullTotalPhys da estrutura MEMORYSTATUSEX com a quantidade de memória física disponível para o sistema operacional usar. A quantidade de memória disponível para o sistema operacional pode ser menor do que a quantidade de memória instalada fisicamente no computador porque o BIOS e alguns drivers podem reservar memória como regiões de E/S para dispositivos mapeados em memória, tornando a memória indisponível para o sistema operacional e os aplicativos.

A quantidade de memória física recuperada pela função GetPhysicallyInstalledSystemMemory deve ser igual ou maior que a quantidade relatada pela função GlobalMemoryStatusEx ; se for menor, os dados SMBIOS serão malformados e a função falhará com ERROR_INVALID_DATA. Dados SMBIOS malformados podem indicar um problema com o computador do usuário.

Requisitos

Confira também

EnumSystemFirmwareTables

GetSystemFirmwareTable

GlobalMemoryStatusEx