IDirect3DTexture8::GetSurfaceLevel

  • Article

This method retrieves the specified texture surface level.

HRESULT GetSurfaceLevel(
  UINT Level,
  Direct3DSurface8** ppSurfaceLevel
);

Parameters

  • Level
    [in] Identifies a level of the texture resource. This method returns a surface for the level specified by this parameter. The top-level surface is denoted by 0.
  • ppSurfaceLevel
    [out, retval] Address of a pointer to an IDirect3DSurface8 interface, representing the returned surface.

Return Values

If the method succeeds, the return value is D3D_OK.

If the method fails, the return value can be one D3DERR_INVALIDCALL.

Remarks

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

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: D3d8.h.
Link Library: D3d8.lib.

See Also

IDirect3DSurface8 | IUnknown::Release | IDirect3DTexture8

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.