Função D3DXCreateRenderToSurface

Artigo
06/13/2023

Cria uma superfície de renderização.

Sintaxe

HRESULT D3DXCreateRenderToSurface(
  _In_  LPDIRECT3DDEVICE9     pDevice,
  _In_  UINT                  Width,
  _In_  UINT                  Height,
  _In_  D3DFORMAT             Format,
  _In_  BOOL                  DepthStencil,
  _In_  D3DFORMAT             DepthStencilFormat,
  _Out_ LPD3DXRENDERTOSURFACE *ppRenderToSurface
);

Parâmetros

pDevice [in]

Tipo: LPDIRECT3DDEVICE9

Ponteiro para uma interface IDirect3DDevice9 , o dispositivo a ser associado à superfície de renderização.

Largura [in]

Tipo: UINT

Largura da superfície de renderização, em pixels.

Altura [in]

Tipo: UINT

Altura da superfície de renderização, em pixels.

Formatar [in]

Tipo: D3DFORMAT

Membro do tipo enumerado D3DFORMAT , descrevendo o formato de pixel da superfície de renderização.

DepthStencil [in]

Tipo: BOOL

Se TRUE, a superfície de renderização dá suporte a uma superfície de estêncil de profundidade. Caso contrário, esse membro será definido como FALSE. Essa função criará um novo buffer de profundidade.

DepthStencilFormat [in]

Tipo: D3DFORMAT

Se DepthStencil for definido como TRUE, esse parâmetro será um membro do tipo enumerado D3DFORMAT , descrevendo o formato de estêncil de profundidade da superfície de renderização.

ppRenderToSurface [out]

Tipo: LPD3DXRENDERTOSURFACE*

Endereço de um ponteiro para uma interface ID3DXRenderToSurface , representando a superfície de renderização criada.

Valor retornado

Tipo: HRESULT

Se a função for bem-sucedida, o valor retornado será D3D_OK. Se a função falhar, o valor retornado poderá ser um dos seguintes: D3DERR_INVALIDCALL, E_OUTOFMEMORY.

Requisitos

Requisito	Valor
parâmetro	D3dx9core.h
Biblioteca	D3dx9.lib

Confira também

Funções Uso Geral

Compartilhar via