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::StretchRectIDirect3DDevice9::ColorFill 的适当池。

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

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

要求

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

另请参阅

IDirect3DDevice9