Compartilhar via


Método IDirect3DDevice9Ex::CreateOffscreenPlainSurfaceEx (d3d9.h)

Crie uma superfície fora da tela.

Sintaxe

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

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.

[in] Usage

Tipo: DWORD

Combinação de uma ou mais constantes D3DUSAGE que podem ser OR'd juntas. O valor 0 indica que não há uso.

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 d3d9.h
Biblioteca D3D9.lib

Confira também

Idirect3ddevice9ex