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

2008-09-17

更新 : 2007 年 11 月

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

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 フラグが設定された静的フィールド。
Context	COM+ コンテキストごとに値が異なる静的フィールド。	ContextStaticAttribute でマークされた静的フィールド。