Metodo IDirect3DDevice9Ex::CreateOffscreenPlainSurfaceEx (d3d9.h)

Creare una superficie fuori schermo.

Sintassi

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

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.

[in] Usage

Tipo: DWORD

Combinazione di una o più costanti D3DUSAGE che possono essere combinate con OR. Il valore 0 indica l'assenza di utilizzo.

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

Vedi anche

IDirect3DDevice9Ex