D3DXCreateRenderToSurface 函数

创建呈现图面。

语法

HRESULT D3DXCreateRenderToSurface(
  _In_  LPDIRECT3DDEVICE9     pDevice,
  _In_  UINT                  Width,
  _In_  UINT                  Height,
  _In_  D3DFORMAT             Format,
  _In_  BOOL                  DepthStencil,
  _In_  D3DFORMAT             DepthStencilFormat,
  _Out_ LPD3DXRENDERTOSURFACE *ppRenderToSurface
);

参数

pDevice [in]

类型： LPDIRECT3DDEVICE9

指向 IDirect3DDevice9 接口（要与呈现图面关联的设备）的指针。

Width [in]

类型： UINT

呈现图面的宽度（以像素为单位）。

高度 [in]

类型： UINT

呈现图面的高度（以像素为单位）。

格式 [in]

类型： D3DFORMAT

D3DFORMAT 枚举类型的成员，描述呈现图面的像素格式。

DepthStencil [in]

类型： BOOL

如果 为 TRUE，则呈现图面支持深度模具表面。 否则，此成员设置为 FALSE。 此函数将创建新的深度缓冲区。

DepthStencilFormat [in]

类型： D3DFORMAT

如果 DepthStencil 设置为 TRUE，则此参数是 D3DFORMAT 枚举类型的成员，用于描述呈现图面的深度模具格式。

ppRenderToSurface [out]

类型： LPD3DXRENDERTOSURFACE*

指向 ID3DXRenderToSurface 接口的指针的地址，表示创建的呈现图面。

返回值

类型： HRESULT

如果函数成功，则返回值D3D_OK。 如果函数失败，则返回值可以是以下值之一：D3DERR_INVALIDCALL、E_OUTOFMEMORY。

要求

另请参阅

常规用途函数