globalMemoryStatus 函式 (winbase.h)

發行項
03/03/2024

[GlobalMemoryStatus 可以傳回不正確的資訊。請改用 GlobalMemoryStatusEx 函式。]

擷取系統目前使用實體和虛擬記憶體的相關信息。

語法

void GlobalMemoryStatus(
  [out] LPMEMORYSTATUS lpBuffer
);

參數

[out] lpBuffer

MEMORYSTATUS 結構的指標。 GlobalMemoryStatus 函式會將目前記憶體可用性的相關信息儲存到這個結構中。

傳回值

無

備註

在記憶體超過 4 GB 的計算機上， GlobalMemoryStatus 函式可以傳回不正確的資訊，回報值為 –1 以表示溢位。因此，應用程式應該改用 GlobalMemoryStatusEx 函式。

在記憶體超過 2 GB 且記憶體少於 4 GB 的 Intel x86 計算機上，GlobalMemoryStatus 函式一律會在 MEMORYSTATUS 結構的 dwTotalPhys 成員中傳回 2 GB。同樣地，如果可用記憶體總計介於 2 到 4 GB 之間，MEMORYSTATUS 結構的 dwAvailPhys 成員將會捨入到 2 GB。如果使用 /LARGEADDRESSAWARE 連結器選項連結可執行檔， GlobalMemoryStatus 函式會傳回這兩個成員中正確的物理記憶體數量。

GlobalMemoryStatus 函式傳回的資訊是 volatile。不保證此函式的兩個循序呼叫會傳回相同的資訊。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	winbase.h (包含 Windows.h)
程式庫	Kernel32.lib
DLL	Kernel32.dll