核心介面
下列的介面是藉由擴充偵錯工具的核心介面Visual Studio SDK。
討論
這些介面主要用來建立偵錯引擎 (DE)。 它們會在這裡依照分類進行組織:
中斷點
內容
核心的伺服器
偵錯引擎
文件
事件
運算式
記憶體
模組
連接埠
處理序
程式
屬性
堆疊框架
執行緒
型別視覺化檢視
可實作介面的實體為:
偵錯引擎 (DE)
連接埠提供者 (PS)
運算式評估工具 (EE)
Visual Studio (VS)
中斷點
這些介面相關的實作和追蹤的中斷點。
介面 |
藉由實作 |
描述 |
---|---|---|
DE |
表示繫結至的記憶體位置的中斷點。 |
|
DE |
繫結中斷點的記憶體位置時,由 DE 傳送。 |
|
VS |
表示中斷點要求的文件加總檢查碼。 |
|
DE |
中斷點無法繫結到的記憶體位置時,由 DE 傳送。 |
|
DE |
當到達中斷點時,由 DE 傳送。 |
|
VS |
表示要求的中斷點。 用於建立暫止中斷點。 |
|
VS |
表示要求的中斷點。 用於建立暫止中斷點。 |
|
DE |
表示用來繫結中斷點的資訊。 |
|
DE |
從記憶體位置中斷點是未繫結時,所 DE 傳送。 |
|
DE |
代表無效的中斷點 (所傳回的IDebugBreakpointErrorEvent2)。 |
|
DE |
表示解析度資訊不正確的中斷點。 |
|
DE |
表示函式中設有中斷點的位置。 |
|
DE |
表示中斷點要繫結。 用於建立繫結的中斷點。 |
|
DE |
表示資料集的繫結中斷點的列舉型別。 |
|
DE |
代表針對不會繫結至的記憶體位置的中斷點的集合的列舉型別。 |
內容
這些介面代表不同的內偵錯程式的內容。
介面 |
藉由實作 |
描述 |
---|---|---|
DE |
代表程式碼指示的起始位置。 |
|
DE |
延伸IDebugCodeContext2介面,可讓模組和程序的介面的擷取。 |
|
VS DE |
代表文件中的位置。 |
|
DE |
表示用來評估運算式的內容。 |
|
DE |
代表在一系列位元組的記憶體中的起始位置。 |
|
DE |
表示在中斷點或例外狀況的堆疊框架內容。 |
|
DE |
表示在中斷點或例外狀況的堆疊框架內容。 |
|
DE |
表示列舉型別資料集的程式碼內容中。 |
核心的伺服器
這些介面代表的電腦正在進行偵錯程式。 這些由實作Visual Studio ,但可以被呼叫,將偵錯引擎。
介面 |
藉由實作 |
描述 |
---|---|---|
VS |
提供存取連接埠和通訊埠供應商,以及電腦的相關資訊。 |
|
VS |
表示IDebugCoreServer2支援遠端偵錯。 |
偵錯引擎
這些介面代表偵錯引擎和其相關聯的事件。
介面 |
藉由實作 |
描述 |
---|---|---|
DE |
代表自訂的偵錯引擎。 |
|
DE |
表示支援載入符號、 JustMyCode 和例外狀況的自訂的偵錯引擎。 |
|
DE |
每個 DE 的新執行個體傳送到代表它已準備好處理偵錯工作。 |
|
DE |
表示支援程式的啟動自訂的偵錯引擎。 |
|
DE PS |
代表會處理多個偵錯引擎的程式節點。 |
|
DE |
提供方法讓偵錯引擎取得介面執行緒、 程式或堆疊框架 SDM。 |
文件
這些介面代表文件 (原始程式檔) 和其相關聯的項目。
介面 |
藉由實作 |
描述 |
---|---|---|
DE |
DE 傳送以要求要開啟的文件。 |
|
DE |
表示從文件的反組譯指令資料流。 |
|
VS DE |
表示 DE,指定一個名稱和類別 ID (CLSID) 所提供的文件。 |
|
DE EE |
代表總和檢查碼的偵錯的文件,可讓元件之間傳遞的加總檢查碼。 |
|
VS DE |
代表文件內容,相對於特定的陳述式和程式碼內容的文件中的位置。 |
|
VS DE |
代表文件中的一般位置。 |
|
VS |
代表原始程式檔中的字元位移的位置。 |
|
VS DE |
表示文字文件 DE 所提供的 (衍生自IDebugDocument2),提供實際的文字。 |
|
DE |
若要指定在記憶體中的原始程式檔的變更傳送 DE。 |
事件
這些介面代表 DE 」 和 「 工作階段偵錯管理員 」 (SDM) 之間傳送的所有事件。
介面 |
藉由實作 |
描述 |
---|---|---|
DE |
DE 傳送以要求要開啟的文件。 |
|
DE |
偵錯引擎 (DE) 這個介面過程中傳送至工作階段偵錯管理員 (SDM) 設定的狀態訊息列符號載入。 |
|
DE |
在完成程式的分頁線時,由 DE 傳送。 |
|
DE |
繫結中斷點時,由 DE 傳送。 |
|
DE |
中斷點無法繫結時,由 DE 傳送。 |
|
DE |
當到達中斷點時,由 DE 傳送。 |
|
DE |
中斷點是未繫結時,所 DE 傳送。 |
|
DE |
傳送 DE 以判斷是否應該停止在特定的位置。 |
|
DE |
若要指定在記憶體中的原始程式檔的變更傳送 DE。 |
|
DE |
每個 DE 的新執行個體傳送到代表它已準備好處理偵錯工作。 |
|
DE |
傳送 DE 來表示所偵錯程式已經準備好執行第一個指令。 |
|
DE |
其他的事件介面,可能會傳回錯誤,用來提供人們可讀取的錯誤訊息的介面。 |
|
DE PS |
介面都衍生自其他所有事件的基底介面。 |
|
VS |
表示事件 (以實作特定的事件介面的物件表示) 會傳送 SDM 所實作的介面。 |
|
DE |
在偵錯程式中發生例外狀況時,所 DE 傳送。 |
|
DE |
完成非同步運算式評估時,由 DE 傳送。 |
|
IDebugFindSymbolEvent2 |
|
已過時。 請勿使用。 |
DE |
被攔截的例外狀況的處理完成後,由 DE 傳送。 |
|
DE |
程式已經完成載入時傳送 DE。 |
|
DE |
傳送將 IDE 顯示 DE 告知性訊息給使用者。 |
|
DE |
當您載入或卸載模組時,由 DE 傳送。 |
|
DE |
訊號Visual Studio偵錯工具使用者介面來警告使用者符號找不到被啟動的可執行檔。 |
|
DE |
傳送將 IDE 顯示 DE 的任意字串。 |
|
VS DE |
連接埠傳送至任何接聽程式通訊連接埠的事件。 |
|
DE PS |
在建立處理程序之後,請傳送 DE 或連接埠。 |
|
DE PS |
當處理程序已被終結時傳送 DE 或連接埠。 |
|
DE PS |
在建立程式之後,請傳送 DE 或連接埠。 |
|
DE PS |
程式已被終結時傳送 DE 或連接埠。 |
|
DE |
啟用偵錯引擎來覆寫預設行為的Visual Studio UI,當您結束偵錯工作階段。 |
|
DE |
程式的名稱變更時傳送從偵錯引擎 (DE) 工作階段偵錯管理員 (SDM)。 |
|
DE |
傳送的是,當新的屬性 (由IDebugProperty2介面) 已建立。 |
|
DE |
屬性已被終結時,所 DE 傳送。 |
|
DE |
傳送 DE 當逐步用盡或進入函式,所以會正確地顯示傳回的值。 |
|
VS |
啟用偵錯引擎讀取公制設定遠端。 |
|
DE |
插入、 多於還是超出指令的步驟完成後,由 DE 傳送。 |
|
DE |
傳送 DE 以指示成功或失敗的載入模組的符號。 |
|
DE |
在建立執行緒之後,由 DE 傳送。 |
|
DE |
在終結執行緒時,所 DE 傳送。 |
|
DE |
執行緒已變更它的名稱時,所 DE 傳送。 |
運算式
這些介面代表特定內文中將被評估的運算式。
介面 |
藉由實作 |
描述 |
---|---|---|
DE |
表示要評估的運算式。 取自IDebugExpressionContext2介面。 |
|
DE |
表示用來評估運算式的內容。 取自IDebugStackFrame2介面。 |
|
DE |
完成非同步運算式評估時,由 DE 傳送。 |
記憶體
這些介面代表記憶體中的位元組序列。
介面 |
藉由實作 |
描述 |
---|---|---|
DE |
表示可讀取或寫入的記憶體中的位元組序列。 |
|
DE |
表示位元組序列的記憶體的位置。 |
模組
這些介面代表相對於可執行檔的模組或。DLL 檔案。
介面 |
藉由實作 |
描述 |
---|---|---|
DE |
代表單一的可執行檔或 DLL。 |
|
DE |
表示IDebugModule2 ,支援符號。 |
|
DE |
當您載入或卸載模組時,由 DE 傳送。 |
|
DE |
表示包含在 PDB 檔的來源伺服器資訊。 |
|
DE |
表示列舉型別資料集未知的模組的IDebugProgram2。 |
連接埠
這些介面代表連接埠和通訊埠供應商。
介面 |
藉由實作 |
描述 |
---|---|---|
VS PS |
代表本機電腦上的預設連接埠。 |
|
VS |
啟用偵錯引擎使用 DCOM 來問Visual Studio ,確定防火牆會封鎖遠端偵錯的 UI。 |
|
VS PS |
表示連接埠。 |
|
PS |
連接埠傳送至任何接聽程式通訊連接埠的事件。 |
|
PS |
代表一個連接埠,可以啟動並終止處理序。 |
|
PS |
用來註冊和取消註冊程式與連接埠。 允許的通訊埠,來追蹤目前正在進行偵錯的程式。 |
|
PS |
代表自訂使用者介面選取 [連接埠。 |
|
VS |
表示連接埠的新的連接埠會建立或找到的要求。 |
|
PS |
表示 [供應商的連接埠。 |
|
PS |
表示可以保存的連接埠的供應商 (儲存至磁碟) 它所建立的連接埠的相關資訊。 |
|
PS |
可讓Visual Studio UI,以顯示內部文字傳輸資訊一節的附加至處理序對話方塊。 |
|
VS |
可讓查詢目標電腦的相關資訊。 |
|
VS PS |
表示一組連接埠上的列舉型別。 |
|
VS |
代表在一組連接埠的供應商的列舉型別。 |
處理序
這些介面代表單一的可執行檔包含一或多個程式處理程序。
介面 |
藉由實作 |
描述 |
---|---|---|
PS,DE |
代表正在電腦上執行的處理序。 |
|
PS,DE |
代表正在支援的處理序偵錯 (用來取代步驟,繼續,並在執行方法IDebugProgram2介面)。 |
|
DE PS |
在建立處理程序之後,請傳送 DE 或連接埠。 |
|
DE PS |
當處理程序已被終結時傳送 DE 或連接埠。 |
|
PS |
表示必須追蹤哪一個工作階段附加至它的處理程序。 |
|
PS |
表示一組連接埠上的處理序的列舉型別。 |
程式
這些介面代表執行的這不一定對應到實體的可執行檔或模組的邏輯單位的程式。
介面 |
藉由實作 |
描述 |
---|---|---|
DE |
表示IDebugProgram2 ,以便與其他同時進行偵錯的程式正常運作。 |
|
DE PS |
代表一個邏輯單位的執行。 |
|
DE PS |
在建立程式之後,請傳送 DE 或連接埠。 |
|
DE PS |
程式已被終結時傳送 DE 或連接埠。 |
|
DE PS |
表示IDebugProgramNode2 ,可以由多個偵錯引擎。 |
|
PS |
表示IDebugProgram2 ,必須能夠追蹤哪一個工作階段附加至它。 |
|
DE PS |
表示IDebugProgram2 ,可能會傳回執行中的程序的相關資訊。 |
|
DE PS |
代表一種程式,才能進行偵錯。 |
|
DE PS |
允許嘗試附加至相關聯的程式,接受通知的程式] 節點。 |
|
DE |
提供方法來查詢有關受該 DE 程式將 DE SDM。 |
|
VS |
若要用來顯示它們正在進行偵錯 SDM 登錄程式使用 DEs。 |
|
DE PS |
表示IDebugProgramNode2 ,可以跨執行緒或處理序界限封送介面。 |
|
DE PS |
表示一組程式的列舉型別。 |
屬性
這些介面代表特定內容,通常的運算式評估結果相關聯的值的屬性。
介面 |
藉由實作 |
描述 |
---|---|---|
EE |
表示IDebugProperty2 ,可以用自訂的方式來顯示它的值。 |
|
DE |
表示堆疊框架、 文件,或運算式評估的結果值。 |
|
DE |
表示IDebugProperty2支援任意長度的字串。 |
|
DE |
傳送的是,當新的屬性 (由IDebugProperty2介面) 已建立。 |
|
DE |
屬性已被終結時,所 DE 傳送。 |
|
DE |
表示參考的屬性,可存在於任何特定的堆疊框架外緣。 |
|
DE |
表示列舉型別資料集的DEBUG_PROPERTY_INFO結構而描述變數、 暫存器、 參數和運算式。 |
|
DE |
表示列舉型別資料集的DEBUG_REFERENCE_INFO結構。 |
堆疊框架
這些介面代表一個堆疊框架的內容中的中斷點或例外狀況發生。
介面 |
藉由實作 |
描述 |
---|---|---|
DE |
表示內容中的中斷點或例外狀況發生。 |
|
DE |
表示IDebugStackFrame2而可以處理攔截例外狀況。 |
|
DE |
表示列舉型別資料集的CODE_PATH結構而指定函式呼叫用來在特定的堆疊框架分時抵達的順序。 |
|
DE |
表示列舉型別資料集的FRAMEINFO結構描述堆疊框架。 |
執行緒
這些介面代表執行緒和其相關聯的事件。
介面 |
藉由實作 |
描述 |
---|---|---|
DE |
代表執行的執行緒。 |
|
DE |
在建立執行緒之後,由 DE 傳送。 |
|
DE |
在終結執行緒時,所 DE 傳送。 |
|
DE |
執行緒已變更它的名稱時,所 DE 傳送。 |
|
DE |
表示列舉型別,透過一組執行緒。 |
型別視覺化檢視
這些介面會提供型別視覺化檢視中的支援。 這些介面通常是由運算式評估工具的方式實作。
介面 |
藉由實作 |
描述 |
---|---|---|
EE |
代表要向型別視覺化檢視的位元組陣列。 |
|
EE |
提供可用來取得要傳遞至型別視覺化檢視的資料存取的方法。 |
|
EE |
表示屬性,可存取IPropertyProxyEESide的實作。 |