Método IDirect3DDevice9::CreateRenderTarget (d3d9helper.h)

Crea una superficie de destino de representación.

Sintaxis

HRESULT CreateRenderTarget(
  [in]          UINT                Width,
  [in]          UINT                Height,
  [in]          D3DFORMAT           Format,
  [in]          D3DMULTISAMPLE_TYPE MultiSample,
  [in]          DWORD               MultisampleQuality,
  [in]          BOOL                Lockable,
  [out, retval] IDirect3DSurface9   **ppSurface,
  [in]          HANDLE              *pSharedHandle
);

Parámetros

[in] Width

Tipo: UINT

Ancho de la superficie de destino de representación, en píxeles.

[in] Height

Tipo: UINT

Alto de la superficie de destino de representación, en píxeles.

[in] Format

Tipo: D3DFORMAT

Miembro del tipo enumerado D3DFORMAT , que describe el formato del destino de representación.

[in] MultiSample

Tipo: D3DMULTISAMPLE_TYPE

Miembro del tipo enumerado D3DMULTISAMPLE_TYPE , que describe el tipo de búfer de muestreo múltiple. Este parámetro especifica el tipo de suavizado de contorno para este destino de representación. Cuando esta superficie se pasa a IDirect3DDevice9::SetRenderTarget, su tipo multisample debe ser el mismo que el de la galería de símbolos de profundidad establecida por IDirect3DDevice9::SetDepthStencilSurface.

[in] MultisampleQuality

Tipo: DWORD

Nivel de calidad. El intervalo válido está entre cero y uno menor que el nivel devuelto por pQualityLevels usado por IDirect3D9::CheckDeviceMultiSampleType. Si se pasa un valor mayor, se devuelve el error, D3DERR_INVALIDCALL. Los valores MultisampleQuality de los destinos de representación emparejados, las superficies de galería de símbolos de profundidad y el tipo multisample deben coincidir.

[in] Lockable

Tipo: BOOL

Los destinos de representación no se pueden bloquear a menos que la aplicación especifique TRUE para Lockable.

Tenga en cuenta que los destinos de representación bloqueables reducen el rendimiento en algún hardware gráfico. El rendimiento de la lectura diferida (mover datos de la memoria de vídeo a la memoria del sistema) depende del tipo de hardware usado (AGP frente a PCI Express) y suele ser mucho menor que el rendimiento de carga (mover datos del sistema a la memoria de vídeo). Si necesita acceso de lectura para representar destinos, use GetRenderTargetData en lugar de destinos de representación bloqueables.

[out, retval] ppSurface

Tipo: IDirect3DSurface9**

Dirección de un puntero a una interfaz IDirect3DSurface9 .

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

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 uno de los siguientes: D3DERR_NOTAVAILABLE, D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY, E_OUTOFMEMORY.

Comentarios

Las superficies de destino de representación se colocan en la clase de memoria D3DPOOL_DEFAULT.

No se admite la creación de destinos de representación multimuestreo y bloqueables.

Requisitos

Plataforma de destino	Windows
Encabezado	d3d9helper.h (incluya D3D9.h)
Library	D3D9.lib

Consulte también

IDirect3DDevice9