IDirect3DCubeTexture9::GetCubeMapSurface

Retrieves a cube texture map surface.

HRESULT GetCubeMapSurface(
  D3DCUBEMAP_FACES FaceType,
  UINT Level,
  IDirect3DSurface9 ** ppCubeMapSurface
);

Parameters

FaceType

[in] Member of the D3DCUBEMAP_FACES enumerated type, identifying a cube map face.

Level

[in] Specifies a level of a mipmapped cube texture.

ppCubeMapSurface

[out] Address of a pointer to an IDirect3DSurface9 interface, representing the returned cube texture map surface.

Return Values

If the method succeeds, the return value is D3D_OK. If the method fails, the return value can be: D3DERR_INVALIDCALL.

Remarks

Calling this method will increase the internal reference count on the IDirect3DSurface9 interface. Failure to call IUnknown::Release when finished using this IDirect3DSurface9 interface results in a memory leak.

Requirements

Header: Declared in D3d9.h.