IDirect3DCubeTexture9::GetCubeMapSurface method

Retrieves a cube texture map surface.

Syntax


HRESULT GetCubeMapSurface(
  [in]  D3DCUBEMAP_FACES  FaceType,
  [in]  UINT              Level,
  [out] IDirect3DSurface9 **ppCubeMapSurface
);

Parameters

FaceType [in]

Type: D3DCUBEMAP_FACES

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

Level [in]

Type: UINT

Specifies a level of a mipmapped cube texture.

ppCubeMapSurface [out]

Type: IDirect3DSurface9**

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

Return value

Type: HRESULT

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

D3D9.h

Library

D3D9.lib

See also

IDirect3DCubeTexture9

 

 

Show: