Metodo IDirect3DDevice9::CreateOffscreenPlainSurface (d3d9helper.h)

Articolo
08/23/2023

Creare una superficie fuori schermo.

Sintassi

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

Parametri

[in] Width

Tipo: UINT

Larghezza della superficie.

[in] Height

Tipo: UINT

Altezza della superficie.

[in] Format

Tipo: D3DFORMAT

Formato della superficie. Vedere D3DFORMAT.

[in] Pool

Tipo: D3DPOOL

Tipo di pool di surface. Vedere D3DPOOL.

[out, retval] ppSurface

Tipo: IDirect3DSurface9**

Puntatore all'interfaccia IDirect3DSurface9 creata.

[in] pSharedHandle

Tipo: HANDLE*

Riservato. Impostare questo parametro su NULL. Questo parametro può essere usato in Direct3D 9 per Windows Vista per condividere le risorse.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito viene D3D_OK. Se il metodo ha esito negativo, il valore restituito può essere il seguente: D3DERR_INVALIDCALL.

Commenti

D3DPOOL_SCRATCH restituirà una superficie con caratteristiche identiche a una superficie creata dal metodo DirectX 8.x CreateImageSurface.

D3DPOOL_DEFAULT è il pool appropriato da usare con IDirect3DDevice9::StretchRect e IDirect3DDevice9::ColorFill.

D3DPOOL_MANAGED non è consentito quando si crea una superficie fuori schermo. Per altre informazioni sui pool di memoria, vedere D3DPOOL.

Le superfici semplici fuori schermo sono sempre bloccabili, indipendentemente dai tipi di pool.

Requisiti


Piattaforma di destinazione	Windows
Intestazione	d3d9helper.h (include D3D9.h)
Libreria	D3D9.lib

Vedi anche

IDirect3DDevice9