中斷點相關的方法

偵錯引擎 (DE) 必須支援中斷點的設定。 Visual Studio 的偵錯支援下列類型的中斷點：

• 繫結

  要求透過 UI，並成功地繫結至指定的程式碼的位置

• 暫止

  透過 UI，但是尚未結合到實際的指示要求

討論

比方說，指示不尚未載入時，就會發生暫止中斷點。 當程式碼載入時，暫止中斷點請試著將繫結至程式碼的相關位置，也就是，程式碼中插入分行符號的指示。 事件都傳送到工作階段偵錯管理員 (SDM) 中，以指示成功的繫結，或是通知發生繫結錯誤。

暫止中斷點也管理自己的內部清單的相對應的繫結中斷點。 暫止中斷點在程式碼，就會造成許多中斷點的插入動作。 Visual Studio 的偵錯 UI 中顯示的樹狀檢視暫止中斷點，其對應的繫結中斷點。

建立和使用暫止中斷點需要實作 IDebugEngine2::CreatePendingBreakpoint 方法，以及下列的方法 IDebugPendingBreakpoint2 介面。

方法	描述
CanBind	決定是否指定暫止中斷點可以繫結至程式碼的位置。
Bind	繫結指定的暫止中斷點至一或多個程式碼的位置。
GetState	取得暫止中斷點的狀態。
GetBreakpointRequest	取得用來建立暫止中斷點的中斷點要求。
啟用	切換暫止中斷點的啟用的狀態。
EnumBoundBreakpoints	列舉所有繫結從暫止中斷點的中斷點。
EnumErrorBreakpoints	列舉所造成的暫止中斷點的所有錯誤中斷點。
Delete	刪除擱置中的中斷點，並從其繫結的所有中斷點。

若要列舉的繫結的中斷點和錯誤中斷點，您必須實作所有方法的 IEnumDebugBoundBreakpoints2 和 IEnumDebugErrorBreakpoints2。

暫止繫結至程式碼的中斷點位置必須實作下列 IDebugBoundBreakpoint2 方法。

方法	描述
GetPendingBreakpoint	取得含有中斷點的暫止中斷點。
GetState	取得繫結中斷點的狀態。
GetBreakpointResolution	取得說明中斷點的中斷點解析度。
啟用	啟用或停用中斷點。
Delete	刪除繫結的中斷點。

解析度及要求資訊需要實作下列 IDebugBreakpointResolution2 方法。

方法	描述
GetBreakpointType	取得中斷點的解析度所表示的型別。
GetResolutionInfo	取得說明中斷點的中斷點解析資訊。

在繫結期間可能發生之錯誤的解決方法需要有實作，下列 IDebugErrorBreakpoint2 方法。

方法	描述
GetPendingBreakpoint	取得包含錯誤中斷點的暫止中斷點。
GetBreakpointResolution	取得描述錯誤中斷點中斷點錯誤解析。

在繫結期間可能發生之錯誤的解決方式也會需要下列的方法 IDebugErrorBreakpointResolution2。

方法	描述
GetBreakpointType	取得中斷點的類型。
GetResolutionInfo	取得中斷點的解析資訊。

檢視在中斷點的原始程式碼會要求您實作的方法 IDebugStackFrame2::GetDocumentContext 及 (或) 方法的 IDebugStackFrame2::GetCodeContext。

請參閱

概念

執行控制以及狀態評估