IDebugBreakpoint2::GetPassCount 方法 (dbgeng.h)
GetPassCount 方法會傳回在觸發斷點之前,原本需要目標到達斷點位置的次數。
語法
HRESULT GetPassCount(
[out] PULONG Count
);
參數
[out] Count
在觸發目標之前,必須先達到斷點的次數。 目標原本需要傳遞斷點而不觸發的次數,就是傳 回 Count 的值減一。
傳回值
傳回碼 | 描述 |
---|---|
|
此方法成功。 |
這個方法也可以傳回錯誤值。 如需詳細資訊,請參閱 傳回值。
備註
GetPassCount 方法會傳回原本觸發斷點所需的點擊次數。 GetCurrentPassCount 方法會傳回仍然必須發生的點擊次數,以觸發斷點。 例如,如果已使用 20 個傳遞計數建立斷點,而且到目前為止已通過 5 個,則此方法 GetPassCount 會傳回 20, 而 GetCurrentPassCount 會傳回 15。
在目標達到足夠的時間觸發斷點之後,除非呼叫 SetPassCount,否則每次叫用斷點時都會觸發斷點。 您也可以呼叫 SetPassCount ,在觸發斷點之前變更傳遞計數。 此呼叫會重設原始的傳遞計數和剩餘的傳遞計數。
如果調試程式在逐步執行程式代碼時於斷點位置執行程式碼,此執行不會參與觸發斷點之前所保留的次數。
GetParameters 方法也會傳回 Count 中傳回的資訊。
如需斷點屬性的詳細資訊,請參閱 控制斷點旗標和參數。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | dbgeng.h (包含 Dbgeng.h) |