ICLRAppDomainResourceMonitor::GetCurrentSurvived メソッド

[アーティクル]
08/09/2011

最後のフルブロッキングガベージコレクションで残ったバイト数、および現在のアプリケーションドメインで参照されているバイト数を取得します。

HRESULT STDMETHODCALLTYPE GetCurrentSurvived(
             [in]  DWORD dwAppDomainId,
             [out] ULONGLONG *pAppDomainBytesSurvived,
             [out] ULONGLONG *pTotalBytesSurvived);

パラメーター

dwAppDomainId
[入力] 要求されたアプリケーションドメインの ID。
pAppDomainBytesSurvived
[出力] このアプリケーションドメインで保持されている、最後のガベージコレクションの後に残ったバイト数へのポインター。フルコレクションの後は、この数が正確かつ完全です。短期コレクションの後は、この数が不完全である可能性があります。このパラメーターには、null を指定できます。
pRuntimeBytesSurvived
[出力] 最後のガベージコレクションで残った合計バイト数へのポインター。フルコレクションの後は、この数が、マネージヒープに保持されているバイト数を表します。短期コレクションの後は、この数が、短期ジェネレーションでライブに保持されているバイト数を表します。このパラメーターには、null を指定できます。

戻り値

このメソッドは、次の特定の HRESULT と、メソッドの失敗を示す HRESULT エラーも返します。

HRESULT	説明
S_OK	メソッドは正常に終了しました。
COR_E_APPDOMAINUNLOADED	アプリケーションドメインがアンロードされています。または、存在しません。

解説

統計情報は、フルブロッキングガベージコレクションの後にのみ更新されます。これは、すべてのジェネレーションを含み、コレクションの発生中にアプリケーションを停止させるコレクションです。たとえば、GC.Collect() メソッドオーバーロードは、フルブロッキングコレクションを実行します。同時実行ガベージコレクションは、バックグラウンドで実行されて、アプリケーションをブロックしません。

GetCurrentSurvived メソッドは、マネージ AppDomain.MonitoringSurvivedMemorySize プロパティと同等のアンマネージメソッドです。