IDirect3DDevice9：：CreateOffscreenPlainSurface 方法 (d3d9helper.h)

  • 项目

创建屏幕外图面。

语法

HRESULT CreateOffscreenPlainSurface(
  [in]          UINT              Width,
  [in]          UINT              Height,
  [in]          D3DFORMAT         Format,
  [in]          D3DPOOL           Pool,
  [out, retval] IDirect3DSurface9 **ppSurface,
  [in]          HANDLE            *pSharedHandle
);

参数

[in] Width

类型： UINT

图面的宽度。

[in] Height

类型： UINT

图面的高度。

[in] Format

类型： D3DFORMAT

图面的格式。 请参阅 D3DFORMAT。

[in] Pool

类型： D3DPOOL

Surface 池类型。 请参阅 D3DPOOL。

[out, retval] ppSurface

类型： IDirect3DSurface9**

指向创建的 IDirect3DSurface9 接口的指针。

[in] pSharedHandle

类型： 句柄*

保留。 将此参数设置为 NULL。 此参数可用于 Direct3D 9 for Windows Vista 共享资源。

返回值

类型： HRESULT

如果方法成功，则返回值D3D_OK。 如果 方法失败，则返回值可以是以下值：D3DERR_INVALIDCALL。

备注

D3DPOOL_SCRATCH将返回与 DirectX 8.x 方法 CreateImageSurface 创建的表面具有相同特征的图面。

D3DPOOL_DEFAULT是用于 IDirect3DDevice9：：StretchRect 和 IDirect3DDevice9：：ColorFill 的适当池。

创建屏幕外普通表面时，不允许D3DPOOL_MANAGED。 有关内存池的详细信息，请参阅 D3DPOOL。

屏幕外普通表面始终可锁定，无论其池类型如何。

要求

   
目标平台 Windows
标头 d3d9helper.h (包括 D3D9.h)
Library D3D9.lib

另请参阅

IDirect3DDevice9