wdbgexts.h ヘッダー
このヘッダーはデバッガーによって使用されます。 詳細については、次を参照してください。
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 Register (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) 関数は expression の値を返します。 式は現在の式エバリュエーターを使用して評価され、エイリアスを含めることができます。 |
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列挙体は、EXT_TYPED_DATA構造体の Operation メンバーで使用され、DEBUG_REQUEST_EXT_TYPED_DATA_ANSI Request 操作が実行するサブ操作を指定します。 |