IDebugSymbols3::GetFunctionEntryByOffset メソッド (dbgeng.h)
GetFunctionEntryByOffset メソッドは、関数の関数エントリ情報を返します。
構文
HRESULT GetFunctionEntryByOffset(
[in] ULONG64 Offset,
[in] ULONG Flags,
[out, optional] PVOID Buffer,
[in] ULONG BufferSize,
[out, optional] PULONG BufferNeeded
);
パラメーター
[in] Offset
関数の実装の現在のプロセスの仮想アドレス空間内の場所を指定します。 これは、GetNextSymbolMatch および IDebugSymbolGroup::GetSymbolOffsetの Offset パラメーターで返される値と、DEBUG_SYMBOL_ENTRY 構造体の Offset フィールドの値です。
[in] Flags
このメソッドの動作を変更するビット フラグを指定します。 ビット DEBUG_GETFNENT_RAW_ENTRY_ONLYが設定されていない場合、エンジンは既知のケースに対して人為的なエントリを提供します。 このビットが設定されている場合、人工エントリは使用されません。
[out, optional] Buffer
関数エントリ情報を受け取ります。 有効なプロセッサが x86 の場合、これは関数のFPO_DATA構造体です。 他のすべてのアーキテクチャでは、これはそのアーキテクチャのIMAGE_FUNCTION_ENTRY構造です。
[in] BufferSize
バッファー バッファーのサイズを指定します。
[out, optional] BufferNeeded
関数エントリ情報のサイズを指定します。
戻り値
このメソッドは、エラー値を返す場合もあります。 詳細については 戻り値の を参照してください。
リターン コード | 形容 |
---|---|
|
メソッドが成功しました。 |
|
メソッドは成功しましたが、バッファーは関数エントリ情報を保持するのに十分な大きさではなかったため、情報が収まるように切り捨てられました。 |
|
Offset の位置関数エントリ情報が見つかりませんでした。 |
備考
FPO_DATAおよびIMAGE_FUNCTION_ENTRYの構造については、「イメージ ヘルプ ライブラリ」に記載されています。このライブラリは、DbgHelp.chm ファイルの Windows 用デバッグ ツールに含まれています。
必要条件
要件 | 価値 |
---|---|
ターゲット プラットフォーム の | デスクトップ |
ヘッダー | dbgeng.h (Dbgeng.h、Winnt.h を含む) |
関連項目
GetNextSymbolMatch の