SymRegisterFunctionEntryCallback64

Alpha コンピュータ上でスタックウォーク処理が使用するコールバック関数を登録する。(SymRegisterFunctionEntryCallback64)

SymRegisterFunctionEntryCallback64 hProcess, CallbackFunction, UserContext

hProcess : [intptr] もともと StackWalk64 関数に渡したプロセスのハンドル。
CallbackFunction : [int] SymRegisterFunctionEntryCallbackProc64 コールバック関数。
UserContext : [int64] ユーザー定義の値または NULL。この値はそのままコールバック関数に渡される。通常、アプリケーションはこのパラメータを使用して、コールバック関数がコンテキストを確立するためのデータ構造へのポインタを渡す。

(プラグイン / モジュール : dbghelp.dll)

解説

Alpha
コンピュータ上でスタックウォーク処理が使用するコールバック関数を登録する。(SymRegisterFunctionEntryCallback64)

[戻り値]
関数が成功した場合、戻り値は TRUE である。関数が失敗した場合、戻り値は FALSE
である。拡張エラー情報を取得するには、GetLastError を呼び出す。

[備考]
SymRegisterFunctionEntryCallback64
関数を使用すると、アプリケーションはスタックウォーク処理が使用するコールバック関数を登録できる。スタックウォーク処理はアドレスに対する関数テーブルエントリを特定できなかった場合に、登録されたコールバック関数を呼び出す。多くの場合、スタックウォーク処理はそのアドレスを含むイメージの関数テーブルから関数テーブルエントリを特定する。しかし関数テーブルエントリがイメージ内に存在しない状況では、このコールバックによりデバッガが別の情報源から関数テーブルエントリを提供できる。たとえば
Alpha
コンピュータ上の実行時生成コードは、例外処理とスタックトレースをサポートするために動的関数テーブルを定義できる。この関数を含め、すべての
DbgHelp
関数はシングルスレッドである。そのため複数のスレッドから同時に呼び出すと、予期しない動作やメモリ破壊を招く可能性が高い。これを避けるには、複数スレッドからの並行呼び出しをすべて同期する必要がある。この関数は
SymRegisterFunctionEntryCallback 関数の後継である。詳細は Updated Platform
Support を参照のこと。SymRegisterFunctionEntryCallback は Dbghelp.h
で次のように定義されている。
（以下省略）

情報