D3DXCreateRenderToEnvMap

Creates a render environment map.

HRESULT D3DXCreateRenderToEnvMap(
  LPDIRECT3DDEVICE8 pDevice,
  UINT Size,
  D3DFORMAT Format,
  BOOL DepthStencil,
  D3DFORMAT DepthStencilFormat,
  LPD3DXRenderToEnvMap* ppRenderToEnvMap
);

Parameters

pDevice

[in] Pointer to an IDirect3DDevice8 interface, which is the device to associate with the render surface.

Size

[in] Size of the render surface.

Format

[in] Member of the D3DFORMAT enumerated type that describes the pixel format of the environment map.

DepthStencil

[in] If TRUE, the render surface supports a depth-stencil surface. Otherwise, this member is set to FALSE.

DepthStencilFormat

[in] If DepthStencil is set to TRUE, this parameter is a member of the D3DFORMAT enumerated type that describes the depth-stencil format of the environment map.

ppRenderToEnvMap

[out, retval] Address of a pointer to an ID3DXRenderToEnvMap interface that represents the created render environment map.

If the function succeeds, the return value is D3D_OK.

If the function fails, the return value can be one of the following values.

Requirements

  Header: Declared in D3dx8core.h.
  Import Library: Use D3dx8.lib.