VS2013 Natvis LegacyAddin 使用方法

1. 自定义类型: MyType

class MyType
{
public:
char m_strName[32];
int m_nAge;
};

2. 编写 natvis 文件: MyType.natvis

<?xml version="1.0" encoding="utf-8"?>
<AutoVisualizer xmlns="http://schemas.microsoft.com/vstudio/debugger/natvis/2010">
<Type Name="MyType">
<DisplayString LegacyAddin="MyType.dll" Export="AddIn_MyType"></DisplayString>
</Type>
</AutoVisualizer>

3. 生成MyType.dll, 导出函数 AddIn_MyType

.h

typedef struct tagDEBUGHELPER
{
DWORD dwVersion;
HRESULT(WINAPI *ReadDebuggeeMemory)(struct tagDEBUGHELPER *pThis, DWORD dwAddr, DWORD nWant, VOID* pWhere, DWORD *nGot);
// from here only when dwVersion >= 0x20000
DWORDLONG(WINAPI *GetRealAddress)(struct tagDEBUGHELPER *pThis);
HRESULT(WINAPI *ReadDebuggeeMemoryEx)(struct tagDEBUGHELPER *pThis, DWORDLONG qwAddr, DWORD nWant, VOID* pWhere, DWORD *nGot);
int (WINAPI *GetProcessorType)(struct tagDEBUGHELPER *pThis);
} DEBUGHELPER;

typedef HRESULT(WINAPI *CUSTOMVIEWER)(DWORD dwAddress, DEBUGHELPER *pHelper, int nBase, BOOL bUniStrings, char *pResult, size_t max, DWORD reserved);

.cpp

static LRESULT ReadMemory(DEBUGHELPER *pHelper, DWORDLONG qwAddr, DWORD nSize, VOID* pBuf, DWORD *nGot)
{
if (pHelper->dwVersion < 0x20000)
{
// Visual C++ 6.0 version
if (pHelper->ReadDebuggeeMemory(pHelper, qwAddr, nSize, pBuf, nGot) != S_OK)
{
return E_FAIL;
}
}
else
{
if (pHelper->ReadDebuggeeMemoryEx(pHelper, qwAddr, nSize, pBuf, nGot) != S_OK)
{
return E_FAIL;
}
}

return S_OK;
}

__declspec(dllexport) HRESULT __stdcall AddIn_MyType(DWORD dwAddress, DEBUGHELPER *pHelper, int nBase, BOOL bUniStrings, char *pResult, size_t max, DWORD reserved)
{
// read file time from debuggee memory space
if (pHelper->dwVersion >= 0x20000)
{
dwAddress = pHelper->GetRealAddress(pHelper);
}

DWORD nGot;
char name[32] = { 0 };
int age = -1;

ReadMemory(pHelper, dwAddress, sizeof(name), name, &nGot);
ReadMemory(pHelper, dwAddress+ 32, sizeof(age), &age, &nGot);

sprintf_s(pResult, max, "name: %s, age: %d", name, age);

return S_OK;
}

4. 部署并测试

将 MyType.natvis 和 MyType.dll 一起放入下面文件夹中的其中之一

%VSINSTALLDIR%\Common7\Packages\Debugger\Visualizers (requires admin access)

%USERPROFILE%\My Documents\Visual Studio 2012\Visualizers\

VS extension folders

测试结果如下：



参考文章：https://stackoverflow.com/questions/11545418/how-to-write-a-custom-native-visualizer-dll-for-visual-studio-2012-debugger/11545420#11545420