GetProcessMemoryInfo 関数 (psapi.h)

[アーティクル]
01/11/2024

指定したプロセスのメモリ使用量に関する情報を取得します。

構文

BOOL GetProcessMemoryInfo(
  [in]  HANDLE                   Process,
  [out] PPROCESS_MEMORY_COUNTERS ppsmemCounters,
  [in]  DWORD                    cb
);

パラメーター

[in] Process

プロセスへのハンドル。ハンドルには、 PROCESS_QUERY_INFORMATION または PROCESS_QUERY_LIMITED_INFORMATION アクセス権が必要です。詳細については、「プロセスのセキュリティとアクセス権」を参照してください。

Windows Server 2003 および Windows XP: ハンドルには、PROCESS_QUERY_INFORMATIONと PROCESS_VM_READ アクセス権が必要です。

[out] ppsmemCounters

プロセスのメモリ使用量に関する情報を受け取るPROCESS_MEMORY_COUNTERS、 PROCESS_MEMORY_COUNTERS_EX、または PROCESS_MEMORY_COUNTERS_EX2 構造体へのポインター。

[in] cb

ppsmemCounters 構造体のサイズ (バイト単位)。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

Windows 7 および Windows Server 2008 R2 以降、Psapi.h は PSAPI 関数のバージョン番号を確立します。 PSAPI バージョン番号は、プログラムが読み込む必要がある関数とライブラリの呼び出しに使用される名前に影響します。

PSAPI_VERSIONが 2 以上の場合、この関数は Psapi.h で K32GetProcessMemoryInfo として定義され、Kernel32.lib および Kernel32.dll でエクスポートされます。 PSAPI_VERSION が 1 の場合、この関数は Psapi.h の GetProcessMemoryInfo として定義され、Psapi.lib でエクスポートされ、K32GetProcessMemoryInfo を呼び出すラッパーとして Psapi.dll されます。

以前のバージョンの Windows および Windows 7 以降のバージョンで実行する必要があるプログラムは、常にこの関数を GetProcessMemoryInfo として呼び出す必要があります。シンボルを正しく解決するには、 PSapi.lib を TARGETLIBS マクロに追加し、 -DPSAPI_VERSION=1 でプログラムをコンパイルします。実行時の動的リンクを使用するには、Psapi.dll を読み込みます。

例

例については、「プロセスのメモリ使用量情報の収集」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows XP [デスクトップアプリ \| UWP アプリ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップアプリのみ \| UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	psapi.h
Library	Windows 7 および Windows Server 2008 R2 の Kernel32.lib。Windows 7 および Windows Server 2008 R2 の Psapi.lib (PSAPI_VERSION=1 の場合)。Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP の Psapi.lib
[DLL]	Windows 7 および Windows Server 2008 R2 で Kernel32.dll。Windows 7 および Windows Server 2008 R2 で Psapi.dll (PSAPI_VERSION=1 の場合)。Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP の Psapi.dll