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

Créez une surface hors écran.

Syntaxe

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

Paramètres

[in] Width

Type : UINT

Largeur de la surface.

[in] Height

Type : UINT

Hauteur de la surface.

[in] Format

Type : D3DFORMAT

Format de la surface. Consultez D3DFORMAT.

[in] Pool

Type : D3DPOOL

Type de pool Surface. Consultez D3DPOOL.

[out, retval] ppSurface

Type : IDirect3DSurface9**

Pointeur vers l’interface IDirect3DSurface9 créée.

[in] pSharedHandle

Type : HANDLE*

Réservé. Définissez ce paramètre sur NULL. Ce paramètre peut être utilisé dans Direct3D 9 pour Windows Vista pour partager des ressources.

[in] Usage

Type : DWORD

Combinaison d’une ou de plusieurs constantes D3DUSAGE qui peuvent être OR’d ensemble. La valeur 0 indique qu’aucune utilisation n’est utilisée.

Valeur retournée

Type : HRESULT

Si la méthode réussit, la valeur de retour est D3D_OK. Si la méthode échoue, la valeur de retour peut être la suivante : D3DERR_INVALIDCALL.

Notes

D3DPOOL_SCRATCH retourne une surface qui a des caractéristiques identiques à une surface créée par la méthode DirectX 8.x CreateImageSurface.

D3DPOOL_DEFAULT est le pool approprié à utiliser avec IDirect3DDevice9::StretchRect et IDirect3DDevice9::ColorFill.

D3DPOOL_MANAGED n’est pas autorisé lors de la création d’une surface ordinaire hors écran. Pour plus d’informations sur les pools de mémoire, consultez D3DPOOL.

Les surfaces simples hors écran sont toujours verrouillables, quel que soit leur type de piscine.

Spécifications

Voir aussi

IDirect3DDevice9Ex