次の方法で共有

FunctionIDMapper2 関数

  • [アーティクル]

関数の特定の識別子が、FunctionEnter3、FunctionLeave3、および FunctionTailcall3、またはその関数の FunctionEnter3WithInfo、FunctionLeave3WithInfo、および FunctionTailcall3WithInfo の各コールバックで使用される代替 ID に再割り当てされることをプロファイラーに通知します。 また FunctionIDMapper2 により、プロファイラーはその関数のコールバックを受信するかどうかを示すことができます。

構文

UINT_PTR __stdcall FunctionIDMapper2 (  
    [in]  FunctionID  funcId,  
    [in]  void * clientData,  
    [out] BOOL       *pbHookFunction  
);

パラメーター

funcId [in] 再マップされる関数識別子。

clientData [in] ランタイム間のあいまいさを解消するために使用されるデータへのポインター。

pbHookFunction [out] プロファイラーが FunctionEnter3、FunctionLeave3、FunctionTailcall3、または FunctionEnter3WithInfo、FunctionLeave3WithInfo、FunctionTailcall3WithInfo の各コールバックを受信するときに、true に設定される値へのポインター。それ以外の場合、この値は false に設定されます。

戻り値

プロファイラーは、実行エンジンが代替関数識別子として使用する値を返します。 false で pbHookFunction を返さない限り、戻り値を null にすることはできません。 これ以外の状況で戻り値を null にすると、プロセスの中止など、予測できない結果が発生します。

解説

このメソッドは、クライアント データを渡すために使用される追加のパラメーターで FunctionIDMapper 関数を拡張します。 クライアント データを使用すると、ランタイム間のあいまいさが解消されます。

要件

:「システム要件」を参照してください。

ヘッダー: CorProf.idl

ライブラリ: CorGuids.lib

.NET Framework のバージョン: 4 以降で使用可能

関連項目