IDirect3D9学习

IDirect3D9接口共14个方法，分别是：

1.创建设备

HRESULT CreateDevice(
  UINT Adapter,
  D3DDEVTYPE DeviceType,
  HWND hFocusWindow,
  DWORD BehaviorFlags,
  D3DPRESENT_PARAMETERS * pPresentationParameters,
  IDirect3DDevice9 ** ppReturnedDeviceInterface
);

参数

[I]Adapter：显卡的序列号，一般使用主显卡D3DADAPTER_DEFAULT

[I]DeviceType：设备类型，HAL or REF，一般都是使用D3DDEVTYPE_HAL

[I]hFocusWindow：窗口句柄

[I]BehaviorFlags：一般使用D3DCREATE_HARDWARE_VERTEXPROCESSING，不过需要用GetDeviceCaps获取caps进行确认

[I]pPresentationParameters：这个结构体在之后会详细说明

[OUT]ppReturnedDeviceInterface:二级指针，返回一个D3D设备接口

用法：

LPDIRECT3DDEVICE9 pDevice = NULL;

D3DPRESENT_PARAMETERS d3dpp; 

ZeroMemory( &d3dpp, sizeof(d3dpp) );
d3dpp.Windowed   = TRUE;
d3dpp.SwapEffect = D3DSWAPEFFECT_COPY;
if( FAILED( g_pD3D->CreateDevice( D3DADAPTER_DEFAULT, 
                                  D3DDEVTYPE_HAL,
                                  hWnd, 
                                  D3DCREATE_SOFTWARE_VERTEXPROCESSING,
				  &d3dpp, 
                                  &d3dDevice)))
	return E_FAIL;

2.检测在一个特定的显示mode下，一个depth-stencil格式是否与渲染目标的格式兼容

HRESULT CheckDepthStencilMatch(
  UINT Adapter,
  D3DDEVTYPE DeviceType,
  D3DFORMAT AdapterFormat,
  D3DFORMAT RenderTargetFormat,
  D3DFORMAT DepthStencilFormat
);

参数：

【I】Adapter：显示设备

【I】DeviceType：设备类型

【I】AdapterFormat：显卡格式

【I】RenderTargetFormat：渲染目标格式

【I】DepthStencilFormat：深度模板格式

用法：

BOOL IsDepthFormatOk(D3DFORMAT DepthFormat, 
                          D3DFORMAT AdapterFormat, 
                          D3DFORMAT BackBufferFormat)
{
    
    // 检查这个depth-stencil格式是否有效
    HRESULT hr = pD3D->CheckDeviceFormat(D3DADAPTER_DEFAULT,
                                         D3DDEVTYPE_HAL,
                                         AdapterFormat,
                                         D3DUSAGE_DEPTHSTENCIL,
                                         D3DRTYPE_SURFACE,
                                         DepthFormat);
    
    if(FAILED(hr)) return FALSE;
    
    // 检查the depth format 和  BackBuffer format是否兼容

    hr = pD3D->CheckDepthStencilMatch(D3DADAPTER_DEFAULT,
                                      D3DDEVTYPE_HAL,
                                      AdapterFormat,
                                      BackBufferFormat,
                                      DepthFormat);
    
    return SUCCEEDED(hr);
    
}

3.在一个显示设备上，检查一个格式（这个格式被用于：texture，depth-stencil buffer，render target，或者这三个的组合）是否可用的

HRESULT CheckDeviceFormat(
  UINT Adapter,
  D3DDEVTYPE DeviceType,
  D3DFORMAT AdapterFormat,
  DWORD Usage,
  D3DRESOURCETYPE RType,
  D3DFORMAT CheckFormat
);

参数：

【I】Adapter：显示设备

【I】DeviceType：设备类型

【I】AdapterFormat：显卡格式

【I】Usage：检查类型

【I】RType：资源类型

【I】CheckFormat：被检查的格式

用法：参照2

4. 测试设备，以确定它是否支持从一种显示格式到另一种显示格式的转换

HRESULT CheckDeviceFormatConversion(
  UINT Adapter,
  D3DDEVTYPE DeviceType,
  D3DFORMAT SourceFormat,
  D3DFORMAT TargetFormat
);

【I】Adapter：显示设备

【I】DeviceType：设备类型

【I】SourceFormat：要检查的格式，必须是FOURCC format or a valid back buffer format

【I】argetFormat：被检查的格式

5.确定多级取样技术在当前设备中是否可用。

HRESULT CheckDeviceMultiSampleType(
  UINT Adapter,
  D3DDEVTYPE DeviceType,
  D3DFORMAT SurfaceFormat,
  BOOL Windowed,
  D3DMULTISAMPLE_TYPE MultiSampleType,
  DWORD* pQualityLevels
);

【I】Adapter：显示设备

【I】DeviceType：设备类型

【I】SurfaceFormat：用于标识要进行多级取样的图面

【I】Windowed：设为 true，则查询有窗口的多级取样。设为 false，则查询全屏多级取样

【I】MultiSampleType：用于标识要测试的多级取样技术

【out】pQualityLevels：一般为NULL

用法：

if( SUCCEEDED(pD3D->CheckDeviceMultiSampleType( pCaps->AdapterOrdinal, 
                                pCaps->DeviceType, BackBufferFormat, 
                                FALSE, D3DMULTISAMPLE_3_SAMPLES, NULL ) ) &&
         SUCCEEDED(pD3D->CheckDeviceMultiSampleType( pCaps->AdapterOrdinal, 
                                pCaps->DeviceType, DepthBufferFormat, 
                                FALSE, D3DMULTISAMPLE_3_SAMPLES, NULL ) ) )
    return S_OK;

6.检查一种硬件加速设备类型是否可以在指定显示上使用

HRESULT CheckDeviceType(
  UINT Adapter,
  D3DDEVTYPE DeviceType,
  D3DFORMAT DisplayFormat,
  D3DFORMAT BackBufferFormat,
  BOOL Windowed
);

参数：

【I】Adapter：显示设备

【I】DeviceType：设备类型

【I】DisplayFormat：被检查的类型

【I】BackBufferFormat：D3DFMT_UNKNOWN is allowed for windowed mode.

【I】Windowed：TRUE:窗口，FALSE:全屏

7，获取显卡的当前Display模式

HRESULT GetAdapterDisplayMode(
  UINT Adapter,
  D3DDISPLAYMODE * pMode
);

参数：

【I】Adapter：显示设备

【I】pMode：D3DDISPLAYMODE 结构体指针

D3DDISPLAYMODE 如下：

typedef struct D3DDISPLAYMODE {
    UINT Width;
    UINT Height;
    UINT RefreshRate;
    D3DFORMAT Format;
} D3DDISPLAYMODE, *LPD3DDISPLAYMODE;

成员说明：

Width：屏幕宽，单位像素

Height：屏幕高，单位像素

RefreshRate：刷新(速)率

Format：显示模式的平面格式

8、获取设备的具体信息

HRESULT GetDeviceCaps(
  UINT Adapter,
  D3DDEVTYPE DeviceType,
  D3DCAPS9 * pCaps
);

参数：

Adapter：显示设备

DeviceType：设备类型

pCaps：D3DCAPS9结构体指针