Поделиться через

Образец EEAddIn: надстройка вычислителя выражений для отладки

  • Статья

В образце EEAddin показано, как расширить собственный вычислитель выражений отладчика, используя API надстройки вычислителя выражений.

Примечание о безопасностиПримечание по безопасности

Этот пример кода иллюстрирует концепцию и содержит только код, относящийся к этой концепции. Он может не отвечать требованиям безопасности для конкретных условий, и его не следует использовать в точности в том виде, в каком он приведен. Чтобы проект был безопасным и надежным, рекомендуется добавить код обеспечения безопасности и код обработки ошибок. Корпорация Майкрософт предоставляет этот пример кода на условиях "КАК ЕСТЬ", без каких-либо гарантий.

Чтобы получить образцы и инструкции по их установке, выполните следующие действия.

Доступ к примерам из Visual Studio

  • В меню Справка выберите пункт Примеры.

    По умолчанию эти примеры устанавливаются в папку диск:\Program Files\Microsoft Visual Studio 10.0\Samples\.

  • Самая последняя версия этого примера и полный список примеров представлены на странице Visual Studio Samples на веб-сайте MSDN.

API надстройки вычислителя выражений

Вычислитель выражений — это компонент отладчика, который интерпретирует (вычисляет) выражения. Если задать точку останова на выражении или ввести выражение в окне отладчика, вычислитель выражений интерпретирует введенные данные. Дополнительные сведения см. в разделе Выражения в отладчике. С помощью API надстройки вычислителя выражений можно расширять возможности вычислителя выражений, дополняя их поддержкой обработки новых типов.

Чтобы дополнить вычислитель выражений поддержкой нового типа, необходимо создать функцию в составе DLL-библиотеки Win32 (в том же каталоге, где находится autoexp.dat) и экспортировать ее по имени. Необходимо также добавить строку в файл autoexp.dat. Вычислитель выражений можно дополнить поддержкой более чем одного типа, экспортируя несколько функций из библиотеки DLL.

Построение и запуск образца

Процедура построения и запуска данного образца состоит из трех частей.

Построение и запуск образца

  1. Постройте библиотеку DLL надстройки вычислителя выражений (eeaddin.dll).

  2. Измените файл autoexp.dat, разрешив в нем использование библиотеки DLL надстройки вычислителя выражений.

  3. Протестируйте надстройку, создав проект с пользовательским типом данных, вычисляемым с помощью autoexp.dat.

Эти шаги подробно описываются в следующих процедурах.

Построение библиотеки DLL надстройки вычислителя выражений

  1. Откройте в Visual Studio решение eeaddin.sln.

  2. В меню Построение выберите команду Построить.

  3. Скопируйте результирующий файл eeaddin.dll в каталог common7\ide (где находится файл devenv.exe).

  4. В меню Файл выберите команду Закрыть решение.

Изменение файла autoexp.dat

  1. В меню Файл выделите команду Открыть и выберите пункт Файл.

  2. В диалоговом окне Открытие файла найдите файл autoexp.dat (в каталоге common7\packages\debugger) и нажмите кнопку Открыть.

  3. Измените файл autoexp.dat, добавив в него следующие строки:

    _SYSTEMTIME=$ADDIN(eeaddin.dll,AddIn_SystemTime@28)
_FILETIME=$ADDIN(eeaddin.dll,AddIn_FileTime@28)

    Сохраните файл autoexp.dat.

Создание проекта с пользовательскими типами данных

  1. В меню Файл выделите команду New и выберите пункт Проект.

  2. В диалоговом окне Создать проект выделите Проекты Visual C++, щелкните Приложение MFC, введите имя для проекта и нажмите кнопку ОК.

  3. В окне Мастер приложений MFC нажмите кнопку Готово. Проект должен быть приложением MFC, поскольку на следующем шаге в него будут добавляться функции MFC.

  4. В приложении MFC добавьте объект SYSTEMTIME или FILETIME.

    SYSTEMTIME *s = new SYSTEMTIME();
FILETIME *f = new FILETIME();
GetSystemTime(s);
SystemTimeToFileTime(s,f);

  5. В меню Построение выберите команду Построить.

  6. Начните отладку, наблюдая за объектом SYSTEMTIME или FILETIME в окне контрольных значений.

Принцип работы образца

Для расширения вычислителя выражений за счет пользовательского типа данных в библиотеке DLL надстройки вычислителя выражений создается функция просмотра. Эта функция использует указатель на объект, находящийся в пространстве памяти отлаживаемой программы (а не в памяти расширяемого вычислителя выражений). Для этого указателя нельзя использовать обычное приведение типов. Необходимо считывать его и указываемые им данные, используя функцию обратного вызова. Указатель обратного вызова типа DEBUGHELPER* указывает на объект различными методами.

Синтаксис выглядит следующим образом.

HRESULT WINAPI CustomViewer(
   DWORD dwAddress,       // low 32-bits of address
   DEBUGHELPER *pHelper,  // callback pointer to access helper functions
   int nBase,             // decimal or hex
   BOOL bIgnore,          // not used
   char *pResult,         // where the result needs to go
   size_t max,            // how large the above buffer is
   DWORD dwReserved       // always pass zero
)

Образец включает две реализации функции этого типа: AddIn_SystemTime и AddIn_FileTime, содержащиеся в файле timeaddin.cpp. Структура DEBUGHELPER (определенная в файле custview.h) состоит из указателей функций, которые могут быть полезны при создании данного расширения. Такой указатель передается в функцию CustomViewer, и его можно использовать для вызова вспомогательных функций.

Получить тип процессора можно с помощью функции pHelper->GetProcessorType. Имеется два метода чтения памяти: pHelper->ReadDebuggeeMemory и pHelper->ReadDebuggeeMemoryEx. Метод ReadDebuggeeMemoryEx обрабатывает 64-битные адреса и поддерживается отладчиком Visual Studio .NET. Метод ReadDebuggeeMemory не обрабатывает 64-битные адреса и поддерживается отладчиками Visual Studio .NET и Visual C++ 6.0. Если надстройка предназначается только для отладчика Visual Studio .NET, можно использовать ReadDebuggeeMemoryEx. Если надстройка должна работать и с отладчиком Visual C++ 6.0, необходимо проверить поле dwVersion и не вызывать ReadDebuggeeMemoryEx для Visual C++ 6.0.

Следующий код работает с обоими отладчиками; в нем считывается содержимое объекта localobject (относящегося к типу MyType) из отлаживаемой программы:

DWORDLONG qwRealAddress;
DWORD dwGot;
MyType localobject;
if (pHelper->dwVersion<0x20000)
{
   // Visual C++ 6.0 version
   qwRealAddress = dwAddress;
   pHelper->ReadDebuggeeMemory( pHelper, dwAddress, 
      sizeof(localobject), &localobject, &dwGot );
}
else
{
   qwRealAddress = pHelper->GetRealAddress(pHelper);
   pHelper->ReadDebuggeeMemoryEx( pHelper, qwRealAddress, 
      sizeof(localobject), &localobject, &dwGot );
}
// TODO: display localobject here

Изменение файла autoexp.dat

Строки, добавляемые в раздел [AutoExpand] файла autoexp.dat, должны использовать следующий синтаксис:

type=$ADDIN(dllname.dll,exportname)

Например:

_SYSTEMTIME=$ADDIN(eeaddin.dll,AddIn_SystemTime)

или

_FILETIME=$ADDIN(eeaddin.dll,AddIn_FileTime)

Если библиотеки DLL нет в каталоге, содержащем файл devenv.exe, или в каталогах пути, заданного переменной PATH, необходимо указать для DLL полное имя пути. Аргумент exportname вводится с учетом регистра символов; он должен в точности совпадать с экспортированным именем, полученным при выполнении функции dumpbin –exports для библиотеки DLL.

Для тестирования отладчика с новой надстройкой сначала прекратите отладку всех программ, которые отлаживались в момент установки новой библиотеки DLL, а затем запустите новый сеанс отладчика.

Примечание. Надстройка выполняется в среде отладчика, поэтому аварийный сбой кода приведет к аварийному завершению IDE.

См. также

Другие ресурсы

Общие образцы