共用方式為


核心介面

下列的介面是藉由擴充偵錯工具的核心介面Visual Studio SDK。

討論

這些介面主要用來建立偵錯引擎 (DE)。 它們會在這裡依照分類進行組織:

  • 中斷點

  • 內容

  • 核心的伺服器

  • 偵錯引擎

  • 文件

  • 事件

  • 運算式

  • 記憶體

  • 模組

  • 連接埠

  • 處理序

  • 程式

  • 屬性

  • 堆疊框架

  • 執行緒

  • 型別視覺化檢視

可實作介面的實體為:

  • 偵錯引擎 (DE)

  • 連接埠提供者 (PS)

  • 運算式評估工具 (EE)

  • Visual Studio (VS)

中斷點

這些介面相關的實作和追蹤的中斷點。

介面

藉由實作

描述

IDebugBoundBreakpoint2

DE

表示繫結至的記憶體位置的中斷點。

IDebugBreakpointBoundEvent2

DE

繫結中斷點的記憶體位置時,由 DE 傳送。

IDebugBreakpointChecksumRequest2

VS

表示中斷點要求的文件加總檢查碼。

IDebugBreakpointErrorEvent2

DE

中斷點無法繫結到的記憶體位置時,由 DE 傳送。

IDebugBreakpointEvent2

DE

當到達中斷點時,由 DE 傳送。

IDebugBreakpointRequest2

VS

表示要求的中斷點。 用於建立暫止中斷點。

IDebugBreakpointRequest3

VS

表示要求的中斷點。 用於建立暫止中斷點。

IDebugBreakpointResolution2

DE

表示用來繫結中斷點的資訊。

IDebugBreakpointUnboundEvent2

DE

從記憶體位置中斷點是未繫結時,所 DE 傳送。

IDebugErrorBreakpoint2

DE

代表無效的中斷點 (所傳回的IDebugBreakpointErrorEvent2)。

IDebugErrorBreakpointResolution2

DE

表示解析度資訊不正確的中斷點。

IDebugFunctionPosition2

DE

表示函式中設有中斷點的位置。

IDebugPendingBreakpoint2

DE

表示中斷點要繫結。 用於建立繫結的中斷點。

IEnumDebugBoundBreakpoints2

DE

表示資料集的繫結中斷點的列舉型別。

IEnumDebugErrorBreakpoints2

DE

代表針對不會繫結至的記憶體位置的中斷點的集合的列舉型別。

內容

這些介面代表不同的內偵錯程式的內容。

介面

藉由實作

描述

IDebugCodeContext2

DE

代表程式碼指示的起始位置。

IDebugCodeContext3

DE

延伸IDebugCodeContext2介面,可讓模組和程序的介面的擷取。

IDebugDocumentContext2

VS DE

代表文件中的位置。

IDebugExpressionContext2

DE

表示用來評估運算式的內容。

IDebugMemoryContext2

DE

代表在一系列位元組的記憶體中的起始位置。

IDebugStackFrame2

DE

表示在中斷點或例外狀況的堆疊框架內容。

IDebugStackFrame3

DE

表示在中斷點或例外狀況的堆疊框架內容。

IEnumDebugCodeContexts2

DE

表示列舉型別資料集的程式碼內容中。

核心的伺服器

這些介面代表的電腦正在進行偵錯程式。 這些由實作Visual Studio ,但可以被呼叫,將偵錯引擎。

介面

藉由實作

描述

IDebugCoreServer2

VS

提供存取連接埠和通訊埠供應商,以及電腦的相關資訊。

IDebugCoreServer3

VS

表示IDebugCoreServer2支援遠端偵錯。

偵錯引擎

這些介面代表偵錯引擎和其相關聯的事件。

介面

藉由實作

描述

IDebugEngine2

DE

代表自訂的偵錯引擎。

IDebugEngine3

DE

表示支援載入符號、 JustMyCode 和例外狀況的自訂的偵錯引擎。

IDebugEngineCreateEvent2

DE

每個 DE 的新執行個體傳送到代表它已準備好處理偵錯工作。

IDebugEngineLaunch2

DE

表示支援程式的啟動自訂的偵錯引擎。

IDebugProgramEngines2

DE PS

代表會處理多個偵錯引擎的程式節點。

IDebugQueryEngine2

DE

提供方法讓偵錯引擎取得介面執行緒、 程式或堆疊框架 SDM。

文件

這些介面代表文件 (原始程式檔) 和其相關聯的項目。

介面

藉由實作

描述

IDebugActivateDocumentEvent2

DE

DE 傳送以要求要開啟的文件。

IDebugDisassemblyStream2

DE

表示從文件的反組譯指令資料流。

IDebugDocument2

VS DE

表示 DE,指定一個名稱和類別 ID (CLSID) 所提供的文件。

IDebugDocumentChecksum2

DE EE

代表總和檢查碼的偵錯的文件,可讓元件之間傳遞的加總檢查碼。

IDebugDocumentContext2

VS DE

代表文件內容,相對於特定的陳述式和程式碼內容的文件中的位置。

IDebugDocumentPosition2

VS DE

代表文件中的一般位置。

IDebugDocumentPositionOffset2

VS

代表原始程式檔中的字元位移的位置。

IDebugDocumentText2

VS DE

表示文字文件 DE 所提供的 (衍生自IDebugDocument2),提供實際的文字。

IDebugDocumentTextEvents2

DE

若要指定在記憶體中的原始程式檔的變更傳送 DE。

事件

這些介面代表 DE 」 和 「 工作階段偵錯管理員 」 (SDM) 之間傳送的所有事件。

介面

藉由實作

描述

IDebugActivateDocumentEvent2

DE

DE 傳送以要求要開啟的文件。

IDebugBeforeSymbolSearchEvent2

DE

偵錯引擎 (DE) 這個介面過程中傳送至工作階段偵錯管理員 (SDM) 設定的狀態訊息列符號載入。

IDebugBreakEvent2

DE

在完成程式的分頁線時,由 DE 傳送。

IDebugBreakpointBoundEvent2

DE

繫結中斷點時,由 DE 傳送。

IDebugBreakpointErrorEvent2

DE

中斷點無法繫結時,由 DE 傳送。

IDebugBreakpointEvent2

DE

當到達中斷點時,由 DE 傳送。

IDebugBreakpointUnboundEvent2

DE

中斷點是未繫結時,所 DE 傳送。

IDebugCanStopEvent2

DE

傳送 DE 以判斷是否應該停止在特定的位置。

IDebugDocumentTextEvents2

DE

若要指定在記憶體中的原始程式檔的變更傳送 DE。

IDebugEngineCreateEvent2

DE

每個 DE 的新執行個體傳送到代表它已準備好處理偵錯工作。

IDebugEntryPointEvent2

DE

傳送 DE 來表示所偵錯程式已經準備好執行第一個指令。

IDebugErrorEvent2

DE

其他的事件介面,可能會傳回錯誤,用來提供人們可讀取的錯誤訊息的介面。

IDebugEvent2

DE PS

介面都衍生自其他所有事件的基底介面。

IDebugEventCallback2

VS

表示事件 (以實作特定的事件介面的物件表示) 會傳送 SDM 所實作的介面。

IDebugExceptionEvent2

DE

在偵錯程式中發生例外狀況時,所 DE 傳送。

IDebugExpressionEvaluationCompleteEvent2

DE

完成非同步運算式評估時,由 DE 傳送。

IDebugFindSymbolEvent2

 

已過時。 請勿使用。

IDebugInterceptExceptionCompleteEvent2

DE

被攔截的例外狀況的處理完成後,由 DE 傳送。

IDebugLoadCompleteEvent2

DE

程式已經完成載入時傳送 DE。

IDebugMessageEvent2

DE

傳送將 IDE 顯示 DE 告知性訊息給使用者。

IDebugModuleLoadEvent2

DE

當您載入或卸載模組時,由 DE 傳送。

IDebugNoSymbolsEvent2

DE

訊號Visual Studio偵錯工具使用者介面來警告使用者符號找不到被啟動的可執行檔。

IDebugOutputStringEvent2

DE

傳送將 IDE 顯示 DE 的任意字串。

IDebugPortEvents2

VS DE

連接埠傳送至任何接聽程式通訊連接埠的事件。

IDebugProcessCreateEvent2

DE PS

在建立處理程序之後,請傳送 DE 或連接埠。

IDebugProcessDestroyEvent2

DE PS

當處理程序已被終結時傳送 DE 或連接埠。

IDebugProgramCreateEvent2

DE PS

在建立程式之後,請傳送 DE 或連接埠。

IDebugProgramDestroyEvent2

DE PS

程式已被終結時傳送 DE 或連接埠。

IDebugProgramDestroyEventFlags2

DE

啟用偵錯引擎來覆寫預設行為的Visual Studio UI,當您結束偵錯工作階段。

IDebugProgramNameChangedEvent2

DE

程式的名稱變更時傳送從偵錯引擎 (DE) 工作階段偵錯管理員 (SDM)。

IDebugPropertyCreateEvent2

DE

傳送的是,當新的屬性 (由IDebugProperty2介面) 已建立。

IDebugPropertyDestroyEvent2

DE

屬性已被終結時,所 DE 傳送。

IDebugReturnValueEvent2

DE

傳送 DE 當逐步用盡或進入函式,所以會正確地顯示傳回的值。

IDebugSettingsCallback2

VS

啟用偵錯引擎讀取公制設定遠端。

IDebugStepCompleteEvent2

DE

插入、 多於還是超出指令的步驟完成後,由 DE 傳送。

IDebugSymbolSearchEvent2

DE

傳送 DE 以指示成功或失敗的載入模組的符號。

IDebugThreadCreateEvent2

DE

在建立執行緒之後,由 DE 傳送。

IDebugThreadDestroyEvent2

DE

在終結執行緒時,所 DE 傳送。

IDebugThreadNameChangedEvent2

DE

執行緒已變更它的名稱時,所 DE 傳送。

運算式

這些介面代表特定內文中將被評估的運算式。

介面

藉由實作

描述

IDebugExpression2

DE

表示要評估的運算式。 取自IDebugExpressionContext2介面。

IDebugExpressionContext2

DE

表示用來評估運算式的內容。 取自IDebugStackFrame2介面。

IDebugExpressionEvaluationCompleteEvent2

DE

完成非同步運算式評估時,由 DE 傳送。

記憶體

這些介面代表記憶體中的位元組序列。

介面

藉由實作

描述

IDebugMemoryBytes2

DE

表示可讀取或寫入的記憶體中的位元組序列。

IDebugMemoryContext2

DE

表示位元組序列的記憶體的位置。

模組

這些介面代表相對於可執行檔的模組或。DLL 檔案。

介面

藉由實作

描述

IDebugModule2

DE

代表單一的可執行檔或 DLL。

IDebugModule3

DE

表示IDebugModule2 ,支援符號。

IDebugModuleLoadEvent2

DE

當您載入或卸載模組時,由 DE 傳送。

IDebugSourceServerModule

DE

表示包含在 PDB 檔的來源伺服器資訊。

IEnumDebugModules2

DE

表示列舉型別資料集未知的模組的IDebugProgram2

連接埠

這些介面代表連接埠和通訊埠供應商。

介面

藉由實作

描述

IDebugDefaultPort2

VS PS

代表本機電腦上的預設連接埠。

IDebugFirewallConfigurationCallback2

VS

啟用偵錯引擎使用 DCOM 來問Visual Studio ,確定防火牆會封鎖遠端偵錯的 UI。

IDebugPort2

VS PS

表示連接埠。

IDebugPortEvents2

PS

連接埠傳送至任何接聽程式通訊連接埠的事件。

IDebugPortEx2

PS

代表一個連接埠,可以啟動並終止處理序。

IDebugPortNotify2

PS

用來註冊和取消註冊程式與連接埠。 允許的通訊埠,來追蹤目前正在進行偵錯的程式。

IDebugPortPicker

PS

代表自訂使用者介面選取 [連接埠。

IDebugPortRequest2

VS

表示連接埠的新的連接埠會建立或找到的要求。

IDebugPortSupplier2

PS

表示 [供應商的連接埠。

IDebugPortSupplier3

PS

表示可以保存的連接埠的供應商 (儲存至磁碟) 它所建立的連接埠的相關資訊。

IDebugPortSupplierDescription2

PS

可讓Visual Studio UI,以顯示內部文字傳輸資訊一節的附加至處理序對話方塊。

IDebugWindowsComputerPort2

VS

可讓查詢目標電腦的相關資訊。

IEnumDebugPorts2

VS PS

表示一組連接埠上的列舉型別。

IEnumDebugPortSuppliers2

VS

代表在一組連接埠的供應商的列舉型別。

處理序

這些介面代表單一的可執行檔包含一或多個程式處理程序。

介面

藉由實作

描述

IDebugProcess2

PS,DE

代表正在電腦上執行的處理序。

IDebugProcess3

PS,DE

代表正在支援的處理序偵錯 (用來取代步驟,繼續,並在執行方法IDebugProgram2介面)。

IDebugProcessCreateEvent2

DE PS

在建立處理程序之後,請傳送 DE 或連接埠。

IDebugProcessDestroyEvent2

DE PS

當處理程序已被終結時傳送 DE 或連接埠。

IDebugProcessEx2

PS

表示必須追蹤哪一個工作階段附加至它的處理程序。

IEnumDebugProcesses2

PS

表示一組連接埠上的處理序的列舉型別。

程式

這些介面代表執行的這不一定對應到實體的可執行檔或模組的邏輯單位的程式。

介面

藉由實作

描述

IDebugEngineProgram2

DE

表示IDebugProgram2 ,以便與其他同時進行偵錯的程式正常運作。

IDebugProgram2

DE PS

代表一個邏輯單位的執行。

IDebugProgramCreateEvent2

DE PS

在建立程式之後,請傳送 DE 或連接埠。

IDebugProgramDestroyEvent2

DE PS

程式已被終結時傳送 DE 或連接埠。

IDebugProgramEngines2

DE PS

表示IDebugProgramNode2 ,可以由多個偵錯引擎。

IDebugProgramEx2

PS

表示IDebugProgram2 ,必須能夠追蹤哪一個工作階段附加至它。

IDebugProgramHost2

DE PS

表示IDebugProgram2 ,可能會傳回執行中的程序的相關資訊。

IDebugProgramNode2

DE PS

代表一種程式,才能進行偵錯。

IDebugProgramNodeAttach2

DE PS

允許嘗試附加至相關聯的程式,接受通知的程式] 節點。

IDebugProgramProvider2

DE

提供方法來查詢有關受該 DE 程式將 DE SDM。

IDebugProgramPublisher2

VS

若要用來顯示它們正在進行偵錯 SDM 登錄程式使用 DEs。

IDebugProviderProgramNode2

DE PS

表示IDebugProgramNode2 ,可以跨執行緒或處理序界限封送介面。

IEnumDebugPrograms2

DE PS

表示一組程式的列舉型別。

屬性

這些介面代表特定內容,通常的運算式評估結果相關聯的值的屬性。

介面

藉由實作

描述

IDebugCustomViewer

EE

表示IDebugProperty2 ,可以用自訂的方式來顯示它的值。

IDebugProperty2

DE

表示堆疊框架、 文件,或運算式評估的結果值。

IDebugProperty3

DE

表示IDebugProperty2支援任意長度的字串。

IDebugPropertyCreateEvent2

DE

傳送的是,當新的屬性 (由IDebugProperty2介面) 已建立。

IDebugPropertyDestroyEvent2

DE

屬性已被終結時,所 DE 傳送。

IDebugReference2

DE

表示參考的屬性,可存在於任何特定的堆疊框架外緣。

IEnumDebugPropertyInfo2

DE

表示列舉型別資料集的DEBUG_PROPERTY_INFO結構而描述變數、 暫存器、 參數和運算式。

IEnumDebugReferenceInfo2

DE

表示列舉型別資料集的DEBUG_REFERENCE_INFO結構。

堆疊框架

這些介面代表一個堆疊框架的內容中的中斷點或例外狀況發生。

介面

藉由實作

描述

IDebugStackFrame2

DE

表示內容中的中斷點或例外狀況發生。

IDebugStackFrame3

DE

表示IDebugStackFrame2而可以處理攔截例外狀況。

IEnumCodePaths2

DE

表示列舉型別資料集的CODE_PATH結構而指定函式呼叫用來在特定的堆疊框架分時抵達的順序。

IEnumDebugFrameInfo2

DE

表示列舉型別資料集的FRAMEINFO結構描述堆疊框架。

執行緒

這些介面代表執行緒和其相關聯的事件。

介面

藉由實作

描述

IDebugThread2

DE

代表執行的執行緒。

IDebugThreadCreateEvent2

DE

在建立執行緒之後,由 DE 傳送。

IDebugThreadDestroyEvent2

DE

在終結執行緒時,所 DE 傳送。

IDebugThreadNameChangedEvent2

DE

執行緒已變更它的名稱時,所 DE 傳送。

IEnumDebugThreads2

DE

表示列舉型別,透過一組執行緒。

型別視覺化檢視

這些介面會提供型別視覺化檢視中的支援。 這些介面通常是由運算式評估工具的方式實作。

介面

藉由實作

描述

IEEDataStorage

EE

代表要向型別視覺化檢視的位元組陣列。

IPropertyProxyEESide

EE

提供可用來取得要傳遞至型別視覺化檢視的資料存取的方法。

IPropertyProxyProvider

EE

表示屬性,可存取IPropertyProxyEESide的實作。

請參閱

參考

API 參考 (Visual Studio 的偵錯)

其他資源

建立自訂偵錯引擎