kmGarbageCollectTexture

Performs garbage collection of texture memory.


KMSTATUS KMAPI
kmGarbageCollectTexture( KMVOID );

Description:

This function performs garbage collection for the frame buffer memory. If there is a vacant area at addresses lower than the already allocated texture surface, the texture is moved and aligned with the lower addresses.

The address of the texture is changed after this function has been called (the contents of pSurface of the KMSURFACEDESC structure are rewritten). Consequently, kmProcessVertexRenderState and kmSetVertexRenderState must be re- executed for all the KMVERTEXCONTEXT structures using texture after this function is used.

Note that the frame buffer area for display and native data buffer are not subject to garbage collection.

Parameters

None

Return values:

ValueExplanation
KMSTATUS_SUCCESS Garbage collection successful
KMSTATUS_NOT_ENOUGH_MEMORY Insufficient memory

  kmGarbageCollectTexture