通过

IDirect3DDevice9Ex：：CreateOffscreenPlainSurfaceEx 方法 (d3d9.h)

  • 项目

创建屏幕外图面。

语法

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

参数

[in] Width

类型： UINT

图面的宽度。

[in] Height

类型： UINT

图面的高度。

[in] Format

类型： D3DFORMAT

图面的格式。 请参阅 D3DFORMAT。

[in] Pool

类型： D3DPOOL

Surface 池类型。 请参阅 D3DPOOL。

[out, retval] ppSurface

类型： IDirect3DSurface9**

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

[in] pSharedHandle

类型： HANDLE*

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

[in] Usage

类型： DWORD

一个或多个 D3DUSAGE 常量的组合，这些常量可以是 OR 组合在一起。 值为 0 表示没有使用。

返回值

类型： HRESULT

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

备注

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

D3DPOOL_DEFAULT是用于 IDirect3DDevice9：：StretchRect 和 IDirect3DDevice9：：ColorFill 的相应池。

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

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

要求

   
目标平台 Windows
标头 d3d9.h
Library D3D9.lib

请参阅

IDirect3DDevice9Ex