DirectX11 With Windows SDK完整目錄
歡迎加入QQ羣: 727623616 可以一起探討DX11，以及有什麼問題也可以在這裏彙報。
綜述
參考文章：https://blogs.msdn.microsoft.com/chuckw/2012/04/24/wheres-dxerr-lib/
在龍書11中所使用的HR宏和dxerr庫是一個比較實用的錯誤原因追蹤工具。D3D中的某些函數擁有返回值HRESULT，通過dxerr庫，可以將錯誤碼轉換成錯誤詳細信息的字符串。
在DirectX SDK中，包含了頭文件dxerr.h和庫文件dxerr.lib，在以往的做法包含了DX SDK後，就可以直接使用dxerr了。但如果是要編寫基於Windows SDK的Direct3D程序，在Windows SDK 8.0以上已經沒有了dxerr庫。
此時此刻，你仍然有兩種選擇來脫離對DirectX SDK的依賴：
- 尋找較新的
dxerr.h和dxerr.cpp源碼來編譯出dxerr.lib，或者直接加入你的項目當中； - 直接拋棄
dxerr庫
新的dxerr源碼
微軟已經將dxerr庫開源了，下面的鏈接可以下載，如果不放心的話，你也可以到上面的參考文章去下載。
在我以往的DirectX11項目中，則是從DXUT中拉過來的dxerr：
但要注意的是，由於新的dxerr.h僅提供了DXTrace的Unicode字符集版本，需要將原來的__FILE__替換爲__FILEW__，並在項目屬性頁中將字符集設置爲Unicode。
拋棄dxerr庫
自Windows SDK 8.0起，HRESULT值關於DirectX圖形API的錯誤消息字符串映射已經加入到FormatMessage函數中。我們可以直接脫離對dxerr的依賴，並使用該函數來直接獲取錯誤消息字符串。因此，dxerr庫也就沒有必要在Windows SDK 8.0以上版本保留了。
FormatMessageW函數--獲取格式化消息字符串
鑑於我們只是要獲取錯誤碼對應的字符串信息，這裏就簡單提及一下該函數的部分用法：
DWORD FormatMessageW(
DWORD dwFlags, // [In]FORMAT_MESSAGE系列宏
LPCVOID lpSource, // [In]直接填NULL
DWORD dwMessageId, // [In]傳入函數異常時返回的HRESULT
DWORD dwLanguageId, // [In]語言ID
LPTSTR lpBuffer, // [In]用於輸出消息字符串的緩衝區
DWORD nSize, // [In]WCHAR緩衝區可容納元素個數
va_list *Arguments // [In]直接填NULL
);DXTraceW函數
這裏我將dxerr中DXTraceW函數的實現進行了修改，由於現在錯誤碼信息爲中文，爲此也順便把錯誤窗口和輸出也漢化了。只需要包含Windows.h和sal.h就可以使用。
函數原型：
// ------------------------------
// DXTraceW函數
// ------------------------------
// 在調試輸出窗口中輸出格式化錯誤信息，可選的錯誤窗口彈出(已漢化)
// [In]strFile 當前文件名，通常傳遞宏__FILEW__
// [In]hlslFileName 當前行號，通常傳遞宏__LINE__
// [In]hr 函數執行出現問題時返回的HRESULT值
// [In]strMsg 用於幫助調試定位的字符串，通常傳遞L#x(可能爲NULL)
// [In]bPopMsgBox 如果爲TRUE，則彈出一個消息彈窗告知錯誤信息
// 返回值: 形參hr
HRESULT WINAPI DXTraceW(_In_z_ const WCHAR* strFile, _In_ DWORD dwLine, _In_ HRESULT hr, _In_opt_ const WCHAR* strMsg, _In_ bool bPopMsgBox);函數實現：
HRESULT WINAPI DXTraceW(_In_z_ const WCHAR* strFile, _In_ DWORD dwLine, _In_ HRESULT hr,
_In_opt_ const WCHAR* strMsg, _In_ bool bPopMsgBox)
{
WCHAR strBufferFile[MAX_PATH];
WCHAR strBufferLine[128];
WCHAR strBufferError[300];
WCHAR strBufferMsg[1024];
WCHAR strBufferHR[40];
WCHAR strBuffer[3000];
swprintf_s(strBufferLine, 128, L"%lu", dwLine);
if (strFile)
{
swprintf_s(strBuffer, 3000, L"%ls(%ls): ", strFile, strBufferLine);
OutputDebugStringW(strBuffer);
}
size_t nMsgLen = (strMsg) ? wcsnlen_s(strMsg, 1024) : 0;
if (nMsgLen > 0)
{
OutputDebugStringW(strMsg);
OutputDebugStringW(L" ");
}
// Windows SDK 8.0起DirectX的錯誤信息已經集成進錯誤碼中，可以通過FormatMessageW獲取錯誤信息字符串
// 不需要分配字符串內存
FormatMessageW(FORMAT_MESSAGE_FROM_SYSTEM | FORMAT_MESSAGE_IGNORE_INSERTS,
nullptr, hr, MAKELANGID(LANG_NEUTRAL, SUBLANG_DEFAULT),
strBufferError, 256, nullptr);
WCHAR* errorStr = wcsrchr(strBufferError, L'\r');
if (errorStr)
{
errorStr[0] = L'\0'; // 擦除FormatMessageW帶來的換行符(把\r\n的\r置換爲\0即可)
}
swprintf_s(strBufferHR, 40, L" (0x%0.8x)", hr);
wcscat_s(strBufferError, strBufferHR);
swprintf_s(strBuffer, 3000, L"錯誤碼含義：%ls", strBufferError);
OutputDebugStringW(strBuffer);
OutputDebugStringW(L"\n");
if (bPopMsgBox)
{
wcscpy_s(strBufferFile, MAX_PATH, L"");
if (strFile)
wcscpy_s(strBufferFile, MAX_PATH, strFile);
wcscpy_s(strBufferMsg, 1024, L"");
if (nMsgLen > 0)
swprintf_s(strBufferMsg, 1024, L"當前調用：%ls\n", strMsg);
swprintf_s(strBuffer, 3000, L"文件名：%ls\n行號：%ls\n錯誤碼含義：%ls\n%ls您需要調試當前應用程序嗎？",
strBufferFile, strBufferLine, strBufferError, strBufferMsg);
int nResult = MessageBoxW(GetForegroundWindow(), strBuffer, L"錯誤", MB_YESNO | MB_ICONERROR);
if (nResult == IDYES)
DebugBreak();
}
return hr;
}注意：上面的函數是初版修改，仍需要大量的實踐以驗證可替代性和穩定性！
HR宏
現在的HR宏變成了這樣：
// ------------------------------
// HR宏
// ------------------------------
// Debug模式下的錯誤提醒與追蹤
#if defined(DEBUG) | defined(_DEBUG)
#ifndef HR
#define HR(x) \
{ \
HRESULT hr = (x); \
if(FAILED(hr)) \
{ \
DXTraceW(__FILEW__, (DWORD)__LINE__, hr, L#x, true);\
} \
}
#endif
#else
#ifndef HR
#define HR(x) (x)
#endif
#endif測試效果如下：
在調試輸出窗口也可以看到：
DirectX11 With Windows SDK完整目錄
歡迎加入QQ羣: 727623616 可以一起探討DX11，以及有什麼問題也可以在這裏彙報。