GetWsChanges

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

GetWsChanges hProcess, lpWatchInfo, cb

hProcess : [intptr] プロセスのハンドル。ハンドルには PROCESS_QUERY_INFORMATION アクセス権が必要である。詳細は「Process Security and Access Rights」を参照。
lpWatchInfo : [var] PSAPI_WS_WATCH_INFORMATION 構造体の配列を受け取る、ユーザーが割り当てたバッファへのポインタ。配列は FaultingPc メンバーが NULL の構造体で終端される。
cb : [int] lpWatchInfo バッファのサイズ（バイト単位）。

(プラグイン / モジュール : psapi.dll)

解説

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

[戻り値]
関数が成功した場合、戻り値は 0 以外となる。関数が失敗した場合、戻り値は 0 となる。拡張エラー情報を取得するには
GetLastError を呼び出す。
lpWatchInfo バッファがすべてのワーキングセット変更レコードを格納するのに十分でない場合、GetLastError は
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 として定義され、K32GetWsChanges を呼び出すラッパーとして Psapi.lib および
Psapi.dll からエクスポートされる。Windows の旧バージョンと Windows 7
以降の両方で動作する必要があるプログラムは、常に GetWsChanges
として呼び出すべきである。シンボル解決を正しく行うには、TARGETLIBS マクロに Psapi.lib
を追加し、-DPSAPI_VERSION=1 を指定してプログラムをコンパイルする。実行時動的リンクを利用するには、Psapi.dll
をロードする。

情報