Skip to content

Latest commit

 

History

History
124 lines (88 loc) · 4.84 KB

ns-winbase-memorystatus.md

File metadata and controls

124 lines (88 loc) · 4.84 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NS:winbase._MEMORYSTATUS
MEMORYSTATUS (winbase.h)
Contains information about the current state of both physical and virtual memory.
*LPMEMORYSTATUS
LPMEMORYSTATUS
LPMEMORYSTATUS structure pointer
MEMORYSTATUS
MEMORYSTATUS structure
_MEMORYSTATUS
_win32_memorystatus_str
base.memorystatus_str
winbase/LPMEMORYSTATUS
winbase/_MEMORYSTATUS
base\memorystatus_str.htm
base
7815ec8f-cacf-4c1b-b5f7-5bb3ef8d759c
12/05/2018
*LPMEMORYSTATUS, LPMEMORYSTATUS, LPMEMORYSTATUS structure pointer, MEMORYSTATUS, MEMORYSTATUS structure, _MEMORYSTATUS, _win32_memorystatus_str, base.memorystatus_str, winbase/LPMEMORYSTATUS, winbase/_MEMORYSTATUS
winbase.h
Windows.h
Windows
Windows XP [desktop apps only]
Windows Server 2003 [desktop apps only]
Windows
MEMORYSTATUS, *LPMEMORYSTATUS
19H1
_MEMORYSTATUS
winbase/_MEMORYSTATUS
LPMEMORYSTATUS
winbase/LPMEMORYSTATUS
MEMORYSTATUS
winbase/MEMORYSTATUS
c++
APIRef
kbSyntax
HeaderDef
WinBase.h
MEMORYSTATUS

MEMORYSTATUS structure

-description

Contains information about the current state of both physical and virtual memory. The GlobalMemoryStatus function stores information in a MEMORYSTATUS structure.

-struct-fields

-field dwLength

The size of the MEMORYSTATUS data structure, in bytes. You do not need to set this member before calling the GlobalMemoryStatus function; the function sets it.

-field dwMemoryLoad

A number between 0 and 100 that specifies the approximate percentage of physical memory that is in use (0 indicates no memory use and 100 indicates full memory use).

-field dwTotalPhys

The amount of actual physical memory, in bytes.

-field dwAvailPhys

The amount of physical memory currently available, in bytes. This is the amount of physical memory that can be immediately reused without having to write its contents to disk first. It is the sum of the size of the standby, free, and zero lists.

-field dwTotalPageFile

The current size of the committed memory limit, in bytes. This is physical memory plus the size of the page file, minus a small overhead.

-field dwAvailPageFile

The maximum amount of memory the current process can commit, in bytes. This value should be smaller than the system-wide available commit. To calculate this value, call GetPerformanceInfo and subtract the value of CommitTotal from CommitLimit.

-field dwTotalVirtual

The size of the user-mode portion of the virtual address space of the calling process, in bytes. This value depends on the type of process, the type of processor, and the configuration of the operating system. For example, this value is approximately 2 GB for most 32-bit processes on an x86 processor and approximately 3 GB for 32-bit processes that are large address aware running on a system with 4 GT RAM Tuning enabled.

-field dwAvailVirtual

The amount of unreserved and uncommitted memory currently in the user-mode portion of the virtual address space of the calling process, in bytes.

-remarks

MEMORYSTATUS reflects the state of memory at the time of the call. It also reflects the size of the paging file at that time. The operating system can enlarge the paging file up to the maximum size set by the administrator.

On computers with more than 4 GB of memory, the MEMORYSTATUS structure can return incorrect information, reporting a value of –1 to indicate an overflow. If your application is at risk for this behavior, use the GlobalMemoryStatusEx function instead of the GlobalMemoryStatus function.

Examples

For an example, see the GlobalMemoryStatus function.

-see-also

GlobalMemoryStatus

GlobalMemoryStatusEx

Memory Performance Information