globalMemoryStatus 函式 (winbase.h)
[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 |