GetWsChanges 関数 (psapi.h)

[アーティクル]
03/05/2024

この関数または InitializeProcessForWsWatch 関数が最後に呼び出されてから、指定したプロセスのワーキングセットに追加されたページに関する情報を取得します。

拡張情報を取得するには、 GetWsChangesEx 関数を使用します。

構文

BOOL GetWsChanges(
  [in]  HANDLE                      hProcess,
  [out] PPSAPI_WS_WATCH_INFORMATION lpWatchInfo,
  [in]  DWORD                       cb
);

パラメーター

[in] hProcess

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

[out] lpWatchInfo

PSAPI_WS_WATCH_INFORMATION構造体の配列を受け取るユーザー割り当てバッファーへのポインター。配列は、 FaultingPc メンバーが NULL である構造体で終了します。

[in] cb

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

戻り値

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

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

getLastError は、lpWatchInfo バッファーがすべてのワーキングセット変更レコードを格納するのに十分な大きさでない場合に、ERROR_INSUFFICIENT_BUFFERを返します。バッファーは空で返されます。バッファーの大きなメモリブロックを再割り当てし、もう一度を呼び出します。

注釈

オペレーティング・システムは、プロセスごとに 1 つのバッファーを使用して、ワーキング・セット変更レコードを保守します。複数のアプリケーション (または同じアプリケーション内の複数のスレッド) が同じプロセスハンドルでこの関数を呼び出す場合、各呼び出しでバッファーが空になるため、どちらのアプリケーションもワーキングセットの変更を完全に説明できません。

オペレーティングシステムは、クエリの処理中 (およびバッファーを空にする) 間、新しい変更レコードを記録しません。関数は、別のクエリの 処理中に同時実行 クエリを受信した場合にNO_MORE_ENTRIESするようにエラーコードを設定します。

バッファーがいっぱいになると、この関数または InitializeProcessForWsWatch 関数が呼び出されるまで、新しいレコードはバッファーに追加されません。データ損失の可能性を防ぐために、十分な頻度でこのメソッドを呼び出す必要があります。レコードが失われた場合、配列は FaultingPc メンバーが NULL で、 FaultingVa メンバーが失われたレコードの数に設定されている構造体で終了します。

Windows Server 2003 および Windows XP: レコードが失われた場合、配列は FaultingPc メンバーが NULL で、 FaultingVa メンバーが 1 である構造体で終了します。

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

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

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

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップアプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
対象プラットフォーム	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