IDirect3DTexture9::GetSurfaceLevel method

Applies to: desktop apps only

Retrieves the specified texture surface level.

Syntax

HRESULT GetSurfaceLevel(
  [in]           UINT Level,
  [out, retval]  IDirect3DSurface9 **ppSurfaceLevel
);

Parameters

Level [in]

Type: UINT

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]

Type: IDirect3DSurface9**

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

Return value

Type: HRESULT

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 IDirect3DSurface9 interface. Failure to call IUnknown::Release when finished using this IDirect3DSurface9 interface results in a memory leak.

Requirements

Send comments about this topic to Microsoft

Build date: 3/6/2012