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

Article
08/23/2023

Créez une surface hors écran.

Syntaxe

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

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.

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 CreateImageSurface DirectX 8.x.

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 pool.

Spécifications


Plateforme cible	Windows
En-tête	d3d9helper.h (incluez D3D9.h)
Bibliothèque	D3D9.lib

Voir aussi

IDirect3DDevice9