DXUT11框架浅析(4)--调试相关

最新推荐文章于 2021-01-19 17:58:16 发布

TechTiger

最新推荐文章于 2021-01-19 17:58:16 发布

阅读量3.1k

点赞数

分类专栏： DXUT11 文章标签： DXUT11 D3D

本文链接：https://blog.csdn.net/techtiger/article/details/11522117

版权

DXUT11 专栏收录该内容

13 篇文章 0 订阅

订阅专栏

DXUT11框架浅析(4)--调试相关

1. D3D8/9和D3D10/11的调试区别

只要安装了DXSDK，有个调试工具DirectX ControlPanel，如下图所示。这里可以将Direct3D 9设置为调试运行时(Debug D3D9 Runtime)或零售运行时(RetailD3D9 Runtime)。注意这里的设置是全局的，如果改成调试运行时，则所有用到D3D9的程序都会进入调试模式，这会使这些程序运行的很慢。

从Vista开始系统自己的界面都使用D3D做渲染，从而必须改变上面的方法，否则系统很容易卡死。从Direct3D 10.0开始，采用了API分层机制，从而有了SDK Debug Layer用于调试。如果需要调试程序，可以在创建D3D设备时使用D3Dxx_CREATE_DEVICE_DEBUG标记或用上面的Control Panel工具把要调试的程序加入调试列表：

2. 调试信息输出函数

下面的函数在DXUTmisc.h中定义：

void WINAPI DXUTOutputDebugStringW( LPCWSTRstrMsg, ... );
void WINAPI DXUTOutputDebugStringA( LPCSTRstrMsg, ... );
 
#ifdef UNICODE
#define DXUTOutputDebugString DXUTOutputDebugStringW
#else
#define DXUTOutputDebugString DXUTOutputDebugStringA
#endif

格式化字符串并通过调用API函数OutputDebugString打印调试信息。比如我们在EmptyProject11这个sample的OnD3D11FrameRender中写一句：

DXUTOutputDebugString(L"Test测试\n" );

调试运行，每当运行到这句时，在Output窗口中都会打印出这个调试信息：

3. D3D结构转成字符串以便于显示

void WINAPI DXUTTraceDecl( D3DVERTEXELEMENT9decl[MAX_FVF_DECL_SIZE]);
WCHAR* WINAPI DXUTTraceD3DDECLUSAGEtoString( BYTE u );
WCHAR* WINAPI DXUTTraceD3DDECLMETHODtoString( BYTE m );
WCHAR* WINAPI DXUTTraceD3DDECLTYPEtoString( BYTE t );
WCHAR* WINAPI DXUTTraceWindowsMessage( UINTuMsg );

4. D3D10以上版本调试信息

void DXUT_SetDebugName( IDirect3DResource9* pObj,const CHAR* pstrName )
void DXUT_SetDebugName( IDXGIObject* pObj,const CHAR* pstrName )
void DXUT_SetDebugName( ID3D10Device* pObj,const CHAR* pstrName )
void DXUT_SetDebugName( ID3D10DeviceChild* pObj,const CHAR* pstrName )
void DXUT_SetDebugName( ID3D11Device* pObj,const CHAR* pstrName )
void DXUT_SetDebugName( ID3D11DeviceChild* pObj,const CHAR* pstrName )

为对象指定一个易读的名称，在调试层出现内存泄漏时，可以很容易看到哪个对象出的问题。

5. PIX辅助调试

#ifdef PROFILE
// PROFILE is defined, so these macros call the D3DPERFfunctions
#define DXUT_BeginPerfEvent( color, pstrMessage)   DXUT_Dynamic_D3DPERF_BeginEvent(color, pstrMessage)
#define DXUT_EndPerfEvent()                         DXUT_Dynamic_D3DPERF_EndEvent()
#define DXUT_SetPerfMarker( color, pstrMessage)    DXUT_Dynamic_D3DPERF_SetMarker(color, pstrMessage)
#else
// PROFILE is not defined, so these macros do nothing
#define DXUT_BeginPerfEvent( color, pstrMessage)   (__noop)
#define DXUT_EndPerfEvent()                         (__noop)
#define DXUT_SetPerfMarker( color, pstrMessage)    (__noop)
#endif
 
class CDXUTPerfEventGenerator

这里实现对D3DPERF_BeginEvent、D3DPERF_BeginEvent、和D3DPERF_BeginEvent三个API的简化使用的封装。主要用于PIX调试Direct3D程序。CDXUTPerfEventGenerator通过类的方式简化了D3DPERF_BeginEvent和D3DPERF_BeginEvent需要配对调用的实现。