D3DXCreateRenderToSurface-Funktion

Erstellt eine Renderoberfläche.

Syntax

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

Parameter

pDevice [in]

Typ: LPDIRECT3DDEVICE9

Zeiger auf eine IDirect3DDevice9-Schnittstelle , das Gerät, das der Renderoberfläche zugeordnet werden soll.

Breite [in]

Typ: UINT

Breite der Renderoberfläche in Pixel.

Höhe [in]

Typ: UINT

Höhe der Renderoberfläche in Pixel.

Formatieren [in]

Typ: D3DFORMAT

Member des aufgezählten D3DFORMAT-Typs , der das Pixelformat der Renderoberfläche beschreibt.

Tiefenschablone [in]

Typ: BOOL

Bei TRUE unterstützt die Renderoberfläche eine Tiefenschablonenoberfläche. Andernfalls ist dieser Member auf FALSE festgelegt. Diese Funktion erstellt einen neuen Tiefenpuffer.

DepthStencilFormat [in]

Typ: D3DFORMAT

Wenn DepthStencil auf TRUE festgelegt ist, ist dieser Parameter ein Element des aufgezählten D3DFORMAT-Typs , der das Format der Tiefenschablone der Renderoberfläche beschreibt.

ppRenderToSurface [out]

Typ: LPD3DXRENDERTOSURFACE*

Adresse eines Zeigers auf eine ID3DXRenderToSurface-Schnittstelle , die die erstellte Renderoberfläche darstellt.

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden sein: D3DERR_INVALIDCALL, E_OUTOFMEMORY.

Anforderungen

Anforderung	Wert
Header	D3dx9core.h
Bibliothek	D3dx9.lib

Siehe auch

Universell-Funktionen