kmCreateCombinedTextureSurface

Secures a combined texture surface.


KMSTATUS KMAPI
kmCreateCombinedTextureSurface(
OUT PKMSURFACEDESC pSurfaceDesc1,
OUT PKMSURFACEDESC pSurfaceDesc2,
IN KMINT32 nWidth,
IN KMINT32 nHeight,
IN KMTEXTURETYPE nTextureType
)

Description:

This function secures a texture surface in texture memory. It secures two texture surfaces of the same size and format. Use the kmFreeTexture function to release the area secured by this function.

This API is kept here for compatibility with ARC1. Therefore, try as much as possible not to use this API.

Like kmCreateTextureSurface, this API can allocate texture surfaces in all formats. KAMUI aligns the first texture surface address and size with a 32-byte boundary.

Caution:

This function must be executed after kmSetSystemConfiguration is called.

Parameters:

pSurfaceDesc1(output)
This parameter is a pointer (No. 1) to KMSURFACEDESC-type structure. Surface information is returned to the structure using the pointer. It becomes undefined if, for KMSTATUS, KMSTATUS_NOT_ENOUGH_MEMORY is returned.

pSurfaceDesc2(output)
This parameter is a pointer (No. 2) to KMSURFACEDESC-type structure. Surface information is returned to the structure using the pointer. It becomes undefined if, for KMSTATUS, KMSTATUS_NOT_ENOUGH_MEMORY is returned.

nWidth, nHeight(input)
These parameters specify the horizontal and vertical texture sizes. If MIPMAP is used, the top-level texture size must be specified. For the square texture, texture size can be between 8x8 and 1024x1024, but the value specified for nWidth or nHeight must be 8, 16, 32, 64, 128, 256, 512, or 1,024.

nTextureType(input)
This parameter specifies a texture format. See KmCreateTextureSurface.

Return values:

ValueExplanation
KMSTATUS_SUCCESS Success
KMSTATUS_INVALID_TEXTURE_TYPE Invalid texture type specified
KMSTATUS_NOT_ENOUGH_MEMORY Insufficient memory

  kmCreateCombinedTextureSurface