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

Cree una superficie fuera de pantalla.

Sintaxis

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

Ancho de la superficie.

[in] Height

Tipo: UINT

Alto de la superficie.

[in] Format

Tipo: D3DFORMAT

Formato de la superficie. Consulte D3DFORMAT.

[in] Pool

Tipo: D3DPOOL

Tipo de grupo de Superficie. Consulte D3DPOOL.

[out, retval] ppSurface

Tipo: IDirect3DSurface9**

Puntero a la interfaz IDirect3DSurface9 creada.

[in] pSharedHandle

Tipo: HANDLE*

Reservado. Establezca este parámetro en NULL. Este parámetro se puede usar en Direct3D 9 para Windows Vista para compartir recursos.

[in] Usage

Tipo: DWORD

Combinación de una o varias constantes D3DUSAGE que pueden ser or'd juntas. El valor de 0 indica que no se ha realizado ningún uso.

Valor devuelto

Tipo: HRESULT

Si el método se ejecuta correctamente, el valor devuelto es D3D_OK. Si se produce un error en el método, el valor devuelto puede ser el siguiente: D3DERR_INVALIDCALL.

Comentarios

D3DPOOL_SCRATCH devolverá una superficie que tenga características idénticas a una superficie creada por el método CreateImageSurface de DirectX 8.x.

D3DPOOL_DEFAULT es el grupo adecuado para su uso con IDirect3DDevice9::StretchRect e IDirect3DDevice9::ColorFill.

D3DPOOL_MANAGED no se permite al crear una superficie sin formato fuera de la pantalla. Para obtener más información sobre los grupos de memoria, consulte D3DPOOL.

Las superficies sin formato fuera de la pantalla siempre se pueden bloquear, independientemente de sus tipos de grupo.

Requisitos

Plataforma de destino	Windows
Encabezado	d3d9.h
Library	D3D9.lib

Consulte también

IDirect3DDevice9Ex