.step_filter (настройка фильтра шагов)
Команда .step_filter создает список функций, пропущенных (перешагнутых) при трассировке. Это позволяет отслеживать код и пропускать только определенные функции. Его также можно использовать в исходном режиме для управления шагами при наличии нескольких вызовов функций в одной строке.
.step_filter "FilterList"
.step_filter /c
.step_filter
Параметры
FilterList
Указывает символы, связанные с функциями, которые необходимо выполнить. FilterList может содержать любое количество текстовых шаблонов, разделенных точкой с запятой. Каждый из этих шаблонов может содержать различные подстановочные знаки и описатели; Дополнительные сведения см. в синтаксисе подстановочных знаков строки. Функция, символ которой соответствует хотя бы одному из этих шаблонов, будет перешагон во время трассировки. Каждый раз при использовании FilterList все предыдущие списки фильтров удаляются и полностью заменяются новым списком.
/c
Очищает список фильтров.
Среда
| Позиция | Description |
|---|---|
| Режимы | Режим пользователя, режим ядра |
| Целевые объекты | Динамический, аварийный дампа |
| Платформы | Все |
Замечания
Без параметров .step_filter отображает текущий список фильтров.
Как правило, команда трассировки (например, t или отладка windbg | шаг в] трассировки в вызов функции. Однако если символ, связанный с вызываемой функцией, соответствует шаблону, указанному FilterList, функция будет перемещена, как если бы использовалась команда шага (например, p).
Если указатель инструкции находится в коде, указанном в списке фильтров, любые команды трассировки или шага будут выходить из этой функции, например команду gu или кнопку "Шаг выхода WinDbg". Конечно, этот фильтр предотвратит трассировку такого кода в первую очередь, поэтому это произойдет только в том случае, если вы изменили фильтр или попали в точку останова.
Например, следующая команда приведет к пропуску команд трассировки во всех вызовах CRT:
.step_filter "msvcrt!*"
Команда .step_filter наиболее полезна при отладке в исходном режиме, так как в одной исходной строке может быть несколько вызовов функций. Команды p и t нельзя использовать для разделения этих вызовов функций.
Например, в следующей строке команда t будет выполняться как в GetTickCount, так и в printf, а команда p будет выполнять оба вызова функции:
printf( "%x\n", GetTickCount() );
Команда .step_filter позволяет отфильтровать один из этих вызовов при трассировке в другую.
Так как функции идентифицируются по символам, один фильтр может включать весь модуль. Это позволяет отфильтровать функции платформы, например вызовы Microsoft Foundation Classes (MFC) или Active Template Library (ATL).
При отладке в режиме сборки каждый вызов находится в другой строке, поэтому можно выбрать, следует ли выполнять пошаговые или трассировки по строкам. Поэтому .step_filter не очень полезно в режиме сборки.