このヘッダーはデバッガーによって使用されます。 詳細については、以下を参照してください。
wdbgexts.h には、次のプログラミング インターフェイスが含まれています。
機能
| GetCurrentProcessAddr の GetCurrentProcessAddr 関数は、現在のプロセスを記述するシステム データの場所を返します。 |
| GetCurrentProcessHandle の GetCurrentProcessHandle 関数は、現在のプロセスのシステム ハンドルを返します。 |
| GetCurrentThreadAddr を GetCurrentThreadAddr 関数は、現在のスレッドを記述するシステム データの場所を返します。 |
| GetDebuggerCacheSize の GetDebuggerCacheSize 関数は、デバッガーがターゲットから取得したデータを保持するために使用されるキャッシュのサイズを返します。 |
| GetDebuggerData を GetDebuggerData 関数は、データ ブロックに格納されている情報を取得します。 |
| GetExpressionEx を GetExpressionEx 関数は式を評価します。 式は MASM エバリュエーターを使用して評価され、エイリアスを含めることができます。 |
| GetFieldData の GetFieldData 関数は、構造体内のメンバーの値を返します。 |
| GetFieldOffset の GetFieldOffset 関数は、構造体の先頭からメンバーのオフセットを返します。 |
| GetFieldValue を GetFieldValue マクロは、GetFieldData 関数のシン ラッパーです。 構造体内のメンバーの値を読み取るための便利な方法として提供されます。 |
| GetInputLine の GetInputLine 関数は、デバッガーに入力文字列を要求します。 |
| GetKdContext の GetKdContext 関数は、プロセッサの合計数と、構造体 ppi が指す現在のプロセッサの数を返します。 |
| GetPebAddress の GetPebAddress 関数は、システム プロセスのプロセス環境ブロック (PEB) のアドレスを返します。 |
| GetSetSympath を GetSetSympath 関数を使用して、シンボル検索パスを取得または設定できます。 |
| GetShortField の GetShortField 関数は、サイズが 8 バイト以下の場合に構造体内のメンバーの値を読み取るか、構造体を初期化して後で読み取ることができるようにします。 |
| GetTebAddress を GetTebAddress 関数は、現在のオペレーティング システム スレッドのスレッド環境ブロック (TEB) のアドレスを返します。 |
|
GetTypeSize GetTypeSize 関数は、指定した型のインスタンスのターゲットのメモリ内のサイズを返します。 |
| IsPtr64 の IsPtr64 関数は、ターゲットが 64 ビット ポインターを使用するかどうかを決定します。 |
|
ListType ListType 関数は、リンクリスト内のすべての要素に対して指定されたコールバック関数を呼び出します。 |
|
ReadControlSpace ReadControlSpace 関数は、プロセッサ固有の制御領域を buf が指す配列に読み取ります。 |
|
ReadControlSpace64 ReadControlSpace64 関数は、プロセッサ固有の制御領域を buf が指す配列に読み取ります。 |
| ReadIoSpace を ReadIoSpace 関数は、システム I/O の場所から読み取ります。 |
|
ReadIoSpace64 ReadIoSpace64 関数は、システム I/O の場所から読み取ります。 |
| ReadIoSpaceEx の ReadIoSpaceEx 関数は、ReadIoSpace の拡張バージョンです。 |
|
ReadIoSpaceEx64 ReadIoSpaceEx64 関数は、ReadIoSpace64 の拡張バージョンです。 |
|
ReadListEntry ReadListEntry 関数は、ターゲットのメモリから二重にリンクされたリスト エントリを読み取ります。 |
| ReadMsr の ReadMsr 関数は、Model-Specific Register (MSR) の内容を読み取ります。 |
| readPhysical の ReadPhysical 関数は、物理メモリから読み取ります。 |
|
ReadPhysicalWithFlags ReadPhysicalWithFlags 関数は、物理メモリから読み取ります。 |
| ReadPointer の ReadPointer 関数は、ターゲットからポインターを読み取ります。 |
|
ReadPtr ReadPtr 関数は、ターゲットからポインターを読み取ります。 ReadPointer の戻り値は WdbgExts API の残りの部分とより一貫性が保たれているので、この関数の代わりに ReadPointer を使用する必要があります。 |
|
ReloadSymbols ReloadSymbols 関数は、必要に応じて再読み込みできるように、デバッガーからシンボル情報を削除します。 この関数は、デバッガー コマンドの .reload と同じように動作します。 |
|
SearchMemory SearchMemory 関数は、ターゲットの仮想メモリで指定されたバイト パターンを検索します。 |
| SetThreadForOperation の SetThreadForOperation 関数は、次の StackTrace 呼び出しに使用するスレッドを設定します。 |
| SetThreadForOperation64 の SetThreadForOperation64 関数は、次の StackTrace 呼び出しに使用するスレッドを設定します。 |
|
TranslateVirtualToPhysical TranslateVirtualToPhysical 関数は、仮想メモリ アドレスを物理メモリ アドレスに変換します。 |
| WriteControlSpace の WriteControlSpace 関数は、現在のターゲットのプロセッサ固有の制御領域に書き込みます。 |
|
WriteIoSpace WriteIoSpace 関数は、システム I/O の場所に書き込みます。 |
| WriteIoSpace64 の WriteIoSpace64 関数は、システム I/O の場所に書き込みます。 |
| WriteIoSpaceEx の WriteIoSpaceEx 関数は、WriteIoSpace の拡張バージョンです。 |
| WriteIoSpaceEx64 の WriteIoSpaceEx64 関数は、WriteIoSpace64 の拡張バージョンです。 |
| WriteMsr の WriteMsr 関数は、Model-Specific レジスタ (MSR) に書き込みます。 |
| writePhysical の WritePhysical 関数は物理メモリに書き込みます。 |
| WritePhysicalWithFlags の WritePhysicalWithFlags 関数は、物理メモリに書き込みます。 |
| WritePointer の WritePointer 関数は、ターゲットへのポインターを書き込みます。 |
コールバック関数
|
PSYM_DUMP_FIELD_CALLBACK PSYM_DUMP_FIELD_CALLBACKコールバック関数は、指定されたシンボル内のメンバーに関する情報を使用して、IG_DUMP_SYMBOL_INFO Ioctl 操作中にデバッガー エンジンによって呼び出されます。 |
|
PWINDBG_CHECK_CONTROL_C PWINDBG_CHECK_CONTROL_C (CheckControlC) 関数は、ユーザーが Ctrl + C キーを押したかどうかを確認します。 すべてのループでPWINDBG_CHECK_CONTROL_Cを使用して、ユーザーが Ctrl + C キーを押して長いプロセスを終了できるようにします。 |
|
PWINDBG_CHECK_VERSION PWINDBG_CHECK_VERSION (CheckVersion) コールバック関数は、拡張機能モジュールのバージョンがデバッガーのバージョンと一致することを確認し、不一致がある場合は警告メッセージを出力します。 |
|
PWINDBG_DISASM PWINDBG_DISASM (Disasm) 関数は、lpOffset が指す命令を逆アセンブルし、印刷可能な文字列を lpBuffer に配置します。 |
|
PWINDBG_EXTENSION_API_VERSION PWINDBG_EXTENSION_API_VERSION (ExtensionApiVersion) コールバック関数は、拡張 DLL に関するバージョン情報を返します。 |
|
PWINDBG_EXTENSION_DLL_INIT PWINDBG_EXTENSION_DLL_INIT (WinDbgExtensionDllInit) コールバック関数は、拡張モジュールの読み込みと初期化に使用されます。 |
|
PWINDBG_GET_EXPRESSION PWINDBG_GET_EXPRESSION (GetExpression) 関数は、式の値を返します。 式は現在の式エバリュエーターを使用して評価され、エイリアスを含めることができます。 |
|
PWINDBG_GET_SYMBOL PWINDBG_GET_SYMBOL (GetSymbol) 関数は、アドレスに最も近いシンボルを検索します。 |
|
PWINDBG_GET_THREAD_CONTEXT_ROUTINE PWINDBG_GET_THREAD_CONTEXT_ROUTINE (GetContext) 関数は、Microsoft Win32 GetThreadContext ルーチンに似た機能を実装します。 デバッグ中のプロセスのコンテキストを返します。 |
|
PWINDBG_IOCTL_ROUTINE PWINDBG_IOCTL_ROUTINE (Ioctl) 関数は、さまざまな操作を実行します。 その機能の多くは、wdbgexts.h の他の関数の機能を反映しています。 |
|
PWINDBG_OUTPUT_ROUTINE コールバック関数は、書式設定された文字列をデバッガー コマンド ウィンドウに出力する機能を実装します。 |
|
PWINDBG_READ_PROCESS_MEMORY_ROUTINE PWINDBG_READ_PROCESS_MEMORY_ROUTINE (ReadMemory) 関数は Win32 ReadProcessMemory 関数と同様に動作します。 デバッグ中のプロセスからメモリを読み取ります。 読み取る領域全体にアクセスできる必要があります。または、操作が失敗します。 |
|
PWINDBG_SET_THREAD_CONTEXT_ROUTINE PWINDBG_SET_THREAD_CONTEXT_ROUTINE (SetContext) 関数は、Win32 SetThreadContext ルーチンに似ています。 デバッグ中のプロセスのコンテキストを設定します。 |
|
PWINDBG_STACKTRACE_ROUTINE PWINDBG_STACKTRACE_ROUTINE (StackTrace) 関数は、デバッグ対象のプロセスのスタック トレースを取得します。 StackFrames が指すバッファーに読み込まれるフレームの数を返します。 |
|
PWINDBG_WRITE_PROCESS_MEMORY_ROUTINE PWINDBG_WRITE_PROCESS_MEMORY_ROUTINE (WriteMemory) 関数は Win32 WriteProcessMemory ルーチンと同様に動作します。 デバッグ中のプロセスにメモリを書き込みます。 書き込む領域全体にアクセスできる必要があります。または、操作が失敗します。 |
構造体
|
BUSDATA IG_GET_BUS_DATA Ioctl 操作はシステム バスからデータを読み取り、IG_SET_BUS_DATA Ioctl 操作はシステム バスにデータを書き込みます。 |
|
DBGKD_GET_VERSION64 IG_GET_KERNEL_VERSION Ioctl 操作は、ターゲットのオペレーティング システムバージョンに関連する情報を受け取ります。 |
|
DEBUG_TYPED_DATA DEBUG_TYPED_DATA構造体は、ターゲットのメモリ内の型指定されたデータを記述します。 |
|
EXT_TYPED_DATA EXT_TYPED_DATA構造体が渡され、DEBUG_REQUEST_EXT_TYPED_DATA_ANSI要求操作から返されます。 これには、操作の入力パラメーターと出力パラメーターと、実行する特定のサブ操作の指定が含まれます。 |
|
FIELD_INFO FIELD_INFO構造体は、構造体内のメンバーに関する情報を提供するために、IG_DUMP_SYMBOL_INFOIoctl操作によって使用されます。 |
|
POINTER_SEARCH_PHYSICAL IG_POINTER_SEARCH_PHYSICAL Ioctl 操作は、ターゲットの物理メモリで、指定された範囲内にあるポインターを検索します。 |
| READCONTROLSPACE を ReadControlSpace 関数がプロセッサ固有の制御領域を buf が指す配列に読み取る方法について説明します。 |
|
READCONTROLSPACE64 ReadControlSpace64 関数がプロセッサ固有の制御領域を buf が指す配列に読み取る方法について説明します。 |
|
SEARCHMEMORY SearchMemory 関数がターゲットの仮想メモリを検索して、指定したバイト パターンを検索する方法について説明します。 |
|
SYM_DUMP_PARAM IG_DUMP_SYMBOL_INFO Ioctl 操作は、シンボルの種類に関する情報を提供します。 |
|
WDBGEXTS_THREAD_OS_INFO IG_GET_THREAD_OS_INFO Ioctl 操作は、ターゲット内のオペレーティング システム スレッドに関する情報を返します。 IoctlType を IG_GET_THREAD_OS_INFO に設定して Ioctl を呼び出す場合、IpvData には WDBGEXTS_THREAD_OS_INFO 構造体のインスタンスが含まれている必要があります。 |
列挙
|
EXT_TDOP EXT_TDOP列挙体は、DEBUG_REQUEST_EXT_TYPED_DATA_ANSI Request 操作が実行するサブ操作を指定するために、EXT_TYPED_DATA構造体の Operation メンバーで使用されます。 |