プロファイル API でのオブジェクト検査

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

このトピックでは、プロファイルメソッドを使用してオブジェクトを検査する方法について説明します。

FunctionEnter2 および FunctionLeave2 コールバック

FunctionEnter2 コールバックおよび FunctionLeave2 コールバックは、関数の引数と戻り値に関する情報を、メモリの領域として提供します。引数は、決められたメモリ領域に左から右に格納されます。次の表に示すように、プロファイラーは、関数のメタデータシグネチャを使用して引数を解釈できます。

ELEMENT_TYPE	表現
プリミティブ (ELEMENT_TYPE <= R8、I、U)	プリミティブ値
値型 (VALUETYPE)	型に依存
参照型 (CLASS、STRING、OBJECT、ARRAY、GENERICINST、SZARRAY)	ObjectID (ガベージコレクションヒープへのポインター)
BYREF	マネージポインター (ObjectID 以外、ただし、スタックまたはガベージコレクションヒープを指している場合があります)
PTR	アンマネージポインター (ガベージコレクションによる移動は不可)
FNPTR	ポインターサイズの非透過値
TYPEDBYREF	マネージポインター、その後にポインターサイズの非透過値

ObjectID とマネージポインターの違いは次のとおりです。

ObjectID は、ガベージコレクションヒープまたは固定したオブジェクトヒープのみを指します。マネージポインターは、スタックを指す場合もあります。
ObjectID は、常にオブジェクトの先頭を指します。マネージポインターは、オブジェクトのフィールドのいずれかを指す場合があります。
マネージポインターは、ObjectID を予期する関数に渡すことはできません。

使用できる CLR 型の一覧については、CorElementType 列挙型を参照してください。

複合型の検査

参照型や非プリミティブ値型の検査には、高度なテクニックが必要となります。

文字列または配列以外の値型および参照型については、ICorProfilerInfo2::GetClassLayout メソッドが各フィールドのオフセットを提供します。その後、プロファイラーは、メタデータを使用してフィールドの型を判断し、再帰的に評価できます。

メモ
GetClassLayout は、そのクラス自体で定義されているフィールドのみを返します。親クラスで定義されているフィールドは含まれません。ICorProfilerInfo2::GetClassIDInfo2 メソッドを使用して親クラスの ClassID を検索し、GetClassLayout を使用して、親クラスで定義されているフィールドに関する情報を取得できます。

GetClassLayout は、そのクラス自体で定義されているフィールドのみを返します。親クラスで定義されているフィールドは含まれません。ICorProfilerInfo2::GetClassIDInfo2 メソッドを使用して親クラスの ClassID を検索し、GetClassLayout を使用して、親クラスで定義されているフィールドに関する情報を取得できます。

ボックス化された値型の場合は、ICorProfilerInfo2::GetBoxClassLayout メソッドを使用して、ボックス内の値型のオフセットを取得できます。値型自体のレイアウトは変化しません。したがって、プロファイラーは、ボックス内の値型が見つかったらすぐに、GetClassLayout を使用してレイアウトを取得できます。

文字列の場合は、ICorProfilerInfo2::GetStringLayout メソッドを使用して、文字列オブジェクト内にある目的のデータのオフセットを取得できます。

配列の場合は若干特殊で、各配列型ではなく各配列オブジェクトに対してメソッドを呼び出す必要があります。これは、配列には多くの形式があり、オフセットを使用して記述することができないためです。解釈を行うための手段として、ICorProfilerInfo2::GetArrayObjectInfo メソッドが用意されています。

静的フィールドの検査

静的フィールドには 4 つの型があります。次の表では、それぞれの内容と識別方法について説明します。

静的型	定義	メタデータでの表現
AppDomain	基本的な静的フィールド。アプリケーションドメインごとに値が異なります。	アタッチされたカスタム属性のない静的フィールド。
スレッド	マネージスレッドローカルストレージ (TLS: Thread-Local Storage)。スレッドおよびアプリケーションドメインごとに固有の値を持つ静的フィールドです。	ThreadStaticAttribute でマークされた静的フィールド。
RVA	モジュールのデータセクションにホームを持つプロセススコープの静的フィールド。	hasRVA フラグが設定された静的フィールド。
コンテキスト	COM+ コンテキストごとに値が異なる静的フィールド。	ContextStaticAttribute でマークされた静的フィールド。