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 如果結構中的成員大小小於或等於8個字節,則 GetShortField 函式會讀取結構中的成員值,或初始化結構,以便稍後進行讀取。 |
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 應該使用,而不是此函式,因為 ReadPointer 的傳回值與 WdbgExts API 的其餘部分更一致。 |
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 調試程式引擎會在IG_DUMP_SYMBOL_INFO Ioctl 作業期間呼叫PSYM_DUMP_FIELD_CALLBACK回呼函式,其中包含指定符號中成員的相關信息。 |
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 Request 作業並從中傳回。 它包含作業的輸入和輸出參數,以及指定要執行的特定子作業。 |
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要求作業將執行的子作業。 |