QueryWorkingSet 関数 (psapi.h)

指定したプロセスのワーキング セットに現在追加されているページに関する情報を取得します。

仮想アドレスのサブセットのワーキング セット情報を取得したり、ワーキング セットの一部ではないページ (AWE や大きなページなど) に関する情報を取得したりするには 、QueryWorkingSetEx 関数を 使用します。

構文

BOOL QueryWorkingSet(
  [in]  HANDLE hProcess,
  [out] PVOID  pv,
  [in]  DWORD  cb
);

パラメーター

[in] hProcess

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

[out] pv

情報を受け取るバッファーへのポインター。 詳細については、「 PSAPI_WORKING_SET_INFORMATION」を参照してください。

pv パラメーターが指すバッファーが、ターゲット・プロセスのすべてのワーキング・セット・エントリーを入れるのに十分な大きさでない場合、この関数はERROR_BAD_LENGTHで失敗します。 この場合、PSAPI_WORKING_SET_INFORMATION構造体の NumberOfEntries メンバーは必要なエントリ数に設定されますが、関数は作業セット エントリに関する情報を返しません。

[in] cb

pv バッファーのサイズ (バイト単位)。

戻り値

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

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

解説

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

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

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

要件

こちらもご覧ください

EnumProcesses

PSAPI 関数

PSAPI_WORKING_SET_INFORMATION

QueryWorkingSetEx

ワーキング セット情報