d3d9.dllGetCubeMapSurface
Microsoft DirectX 9.0 SDK Update (October 2004)

IDirect3DCubeTexture9::GetCubeMapSurface Method


Retrieves a cube texture map surface.

Syntax

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 Value

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.



© 2004 Microsoft Corporation. All rights reserved.
Feedback? Please provide us with your comments on this topic.
For more help, visit the DirectX Developer Center.