Método IDirect3DDevice9::CreateOffscreenPlainSurface (d3d9helper.h)

Crie uma superfície fora da tela.

Sintaxe

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

Parâmetros

[in] Width

Tipo: UINT

Largura da superfície.

[in] Height

Tipo: UINT

Altura da superfície.

[in] Format

Tipo: D3DFORMAT

Formato da superfície. Consulte D3DFORMAT.

[in] Pool

Tipo: D3DPOOL

Tipo de pool do Surface. Consulte D3DPOOL.

[out, retval] ppSurface

Tipo: IDirect3DSurface9**

Ponteiro para a interface IDirect3DSurface9 criada.

[in] pSharedHandle

Tipo: HANDLE*

Reservado. Defina esse parâmetro como NULL. Esse parâmetro pode ser usado no Direct3D 9 para o Windows Vista compartilhar recursos.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será D3D_OK. Se o método falhar, o valor retornado poderá ser o seguinte: D3DERR_INVALIDCALL.

Comentários

D3DPOOL_SCRATCH retornará uma superfície que tem características idênticas a uma superfície criada pelo método DirectX 8.x CreateImageSurface.

D3DPOOL_DEFAULT é o pool apropriado para uso com iDirect3DDevice9::StretchRect e IDirect3DDevice9::ColorFill.

D3DPOOL_MANAGED não é permitido ao criar uma superfície simples fora da tela. Para obter mais informações sobre pools de memória, consulte D3DPOOL.

Superfícies simples fora da tela são sempre bloqueáveis, independentemente de seus tipos de pool.

Requisitos

Plataforma de Destino	Windows
Cabeçalho	d3d9helper.h (inclua D3D9.h)
Biblioteca	D3D9.lib

Confira também

IDirect3DDevice9