ホーム › System.SystemInformation › MEMORYSTATUSEX

MEMORYSTATUSEX

構造体

サイズx64: 64 バイト / x86: 64 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールド	型	サイズ	x64	x86	説明
dwLength	DWORD	4	+0	+0	この構造体のサイズ (バイト単位)。 GlobalMemoryStatusEx を呼び出す前に、このメンバーを設定する必要があります。
dwMemoryLoad	DWORD	4	+4	+4	使用中の物理メモリのおおよその割合を示す、0 から 100 までの数値です (0 はメモリが使用されていないことを示し、100 はメモリがすべて使用されていることを示します)。
ullTotalPhys	ULONGLONG	8	+8	+8	実際の物理メモリの量 (バイト単位)。
ullAvailPhys	ULONGLONG	8	+16	+16	現在使用可能な物理メモリの量 (バイト単位)。これは、内容を先にディスクへ書き込むことなく直ちに再利用できる物理メモリの量です。スタンバイリスト、フリーリスト、およびゼロリストのサイズの合計です。
ullTotalPageFile	ULONGLONG	8	+24	+24	システムまたは現在のプロセスのいずれか小さい方の、現在のコミットメモリ制限 (バイト単位)。システム全体のコミットメモリ制限を取得するには、GetPerformanceInfo を呼び出します。
ullAvailPageFile	ULONGLONG	8	+32	+32	現在のプロセスがコミットできるメモリの最大量 (バイト単位)。この値は、システム全体の使用可能なコミット値と等しいか、それより小さくなります。システム全体の使用可能なコミット値を計算するには、GetPerformanceInfo を呼び出し、CommitLimit の値から CommitTotal の値を減算します。
ullTotalVirtual	ULONGLONG	8	+40	+40	呼び出し元プロセスの仮想アドレス空間のうち、ユーザーモード部分のサイズ (バイト単位)。この値は、プロセスの種類、プロセッサの種類、およびオペレーティングシステムの構成によって異なります。たとえば、x86 プロセッサ上のほとんどの 32 ビットプロセスではおよそ 2 GB、4 ギガバイトチューニングが有効なシステムで動作するラージアドレス対応の 32 ビットプロセスではおよそ 3 GB になります。
ullAvailVirtual	ULONGLONG	8	+48	+48	呼び出し元プロセスの仮想アドレス空間のユーザーモード部分において、現在予約もコミットもされていないメモリの量 (バイト単位)。
ullAvailExtendedVirtual	ULONGLONG	8	+56	+56	予約済みです。この値は常に 0 です。

公式ドキュメント

拡張メモリを含む、物理メモリと仮想メモリの現在の状態に関する情報を格納します。 GlobalMemoryStatusEx 関数は、この構造体に情報を格納します。

解説(Remarks)

MEMORYSTATUSEX は、呼び出した時点でのメモリの状態を反映します。また、その時点でのページファイルのサイズも反映します。オペレーティングシステムは、管理者が設定した最大サイズまでページファイルを拡大できます。

返される物理メモリのサイズには、すべてのノードのメモリが含まれます。

例

例については、 GlobalMemoryStatusEx 関数を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// MEMORYSTATUSEX  (x64 64 / x86 64 バイト)
typedef struct MEMORYSTATUSEX {
    DWORD dwLength;
    DWORD dwMemoryLoad;
    ULONGLONG ullTotalPhys;
    ULONGLONG ullAvailPhys;
    ULONGLONG ullTotalPageFile;
    ULONGLONG ullAvailPageFile;
    ULONGLONG ullTotalVirtual;
    ULONGLONG ullAvailVirtual;
    ULONGLONG ullAvailExtendedVirtual;
} MEMORYSTATUSEX;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct MEMORYSTATUSEX
{
    public uint dwLength;
    public uint dwMemoryLoad;
    public ulong ullTotalPhys;
    public ulong ullAvailPhys;
    public ulong ullTotalPageFile;
    public ulong ullAvailPageFile;
    public ulong ullTotalVirtual;
    public ulong ullAvailVirtual;
    public ulong ullAvailExtendedVirtual;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure MEMORYSTATUSEX
    Public dwLength As UInteger
    Public dwMemoryLoad As UInteger
    Public ullTotalPhys As ULong
    Public ullAvailPhys As ULong
    Public ullTotalPageFile As ULong
    Public ullAvailPageFile As ULong
    Public ullTotalVirtual As ULong
    Public ullAvailVirtual As ULong
    Public ullAvailExtendedVirtual As ULong
End Structure

import ctypes
from ctypes import wintypes

class MEMORYSTATUSEX(ctypes.Structure):
    _fields_ = [
        ("dwLength", wintypes.DWORD),
        ("dwMemoryLoad", wintypes.DWORD),
        ("ullTotalPhys", ctypes.c_ulonglong),
        ("ullAvailPhys", ctypes.c_ulonglong),
        ("ullTotalPageFile", ctypes.c_ulonglong),
        ("ullAvailPageFile", ctypes.c_ulonglong),
        ("ullTotalVirtual", ctypes.c_ulonglong),
        ("ullAvailVirtual", ctypes.c_ulonglong),
        ("ullAvailExtendedVirtual", ctypes.c_ulonglong),
    ]

#[repr(C)]
pub struct MEMORYSTATUSEX {
    pub dwLength: u32,
    pub dwMemoryLoad: u32,
    pub ullTotalPhys: u64,
    pub ullAvailPhys: u64,
    pub ullTotalPageFile: u64,
    pub ullAvailPageFile: u64,
    pub ullTotalVirtual: u64,
    pub ullAvailVirtual: u64,
    pub ullAvailExtendedVirtual: u64,
}

import "golang.org/x/sys/windows"

type MEMORYSTATUSEX struct {
	dwLength uint32
	dwMemoryLoad uint32
	ullTotalPhys uint64
	ullAvailPhys uint64
	ullTotalPageFile uint64
	ullAvailPageFile uint64
	ullTotalVirtual uint64
	ullAvailVirtual uint64
	ullAvailExtendedVirtual uint64
}

type
  MEMORYSTATUSEX = record
    dwLength: DWORD;
    dwMemoryLoad: DWORD;
    ullTotalPhys: UInt64;
    ullAvailPhys: UInt64;
    ullTotalPageFile: UInt64;
    ullAvailPageFile: UInt64;
    ullTotalVirtual: UInt64;
    ullAvailVirtual: UInt64;
    ullAvailExtendedVirtual: UInt64;
  end;

const MEMORYSTATUSEX = extern struct {
    dwLength: u32,
    dwMemoryLoad: u32,
    ullTotalPhys: u64,
    ullAvailPhys: u64,
    ullTotalPageFile: u64,
    ullAvailPageFile: u64,
    ullTotalVirtual: u64,
    ullAvailVirtual: u64,
    ullAvailExtendedVirtual: u64,
};

type
  MEMORYSTATUSEX {.bycopy.} = object
    dwLength: uint32
    dwMemoryLoad: uint32
    ullTotalPhys: uint64
    ullAvailPhys: uint64
    ullTotalPageFile: uint64
    ullAvailPageFile: uint64
    ullTotalVirtual: uint64
    ullAvailVirtual: uint64
    ullAvailExtendedVirtual: uint64

struct MEMORYSTATUSEX
{
    uint dwLength;
    uint dwMemoryLoad;
    ulong ullTotalPhys;
    ulong ullAvailPhys;
    ulong ullTotalPageFile;
    ulong ullAvailPageFile;
    ulong ullTotalVirtual;
    ulong ullAvailVirtual;
    ulong ullAvailExtendedVirtual;
}

HSP用定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; MEMORYSTATUSEX サイズ: 64 バイト(x64)
dim st, 16    ; 4byte整数×16(構造体サイズ 64 / 4 切り上げ)
; dwLength : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwMemoryLoad : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; ullTotalPhys : ULONGLONG (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; ullAvailPhys : ULONGLONG (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; ullTotalPageFile : ULONGLONG (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; ullAvailPageFile : ULONGLONG (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; ullTotalVirtual : ULONGLONG (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; ullAvailVirtual : ULONGLONG (+48, 8byte)  qpoke st,48,値 / qpeek(st,48)  ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; ullAvailExtendedVirtual : ULONGLONG (+56, 8byte)  qpoke st,56,値 / qpeek(st,56)  ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global MEMORYSTATUSEX
    #field int dwLength
    #field int dwMemoryLoad
    #field int64 ullTotalPhys
    #field int64 ullAvailPhys
    #field int64 ullTotalPageFile
    #field int64 ullAvailPageFile
    #field int64 ullTotalVirtual
    #field int64 ullAvailVirtual
    #field int64 ullAvailExtendedVirtual
#endstruct

stdim st, MEMORYSTATUSEX        ; NSTRUCT 変数を確保
st->dwLength = 100
mes "dwLength=" + st->dwLength