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 |