Changes TextureSurface.(KMVERTEXBUFFDESC Structure)

Prototype declaration:


KMSTATUS KMAPI
kmChangeContextTextureSurface(
        IN OUT  PKMVERTEXBUFFDESC   pVertexBuffDesc,
        IN      PKMSURFACEDESC      pTextureSurfaceDesc
);

Description:

This function changes the rendering parameter TextureSurface that was registered in pGlobalParam
from pVertexBuffDesc by kmSetVertexRenderState/kmSetStripHead.
The following is a list of supported VertexType:
In addition, because the PaletteBank information is initialized as a result of executing this API,
set the PaletteBank information through kmChangeContextPaletteBank if necessary.
Note:
    This function changes some of pGlobalParam from pVertexBuffDesc before starting a strip
    in response to kmStartVertexStrip.  Operation is not guaranteed if the rendering parameters
    are not registered from pVertexBuffDesc to pGlobalParam within the same pass beforehand.

VertexType00 VertexType06 VertexType12
VertexType01 VertexType07 VertexType13
VertexType02 VertexType08 VertexType14
VertexType03 VertexType09 VertexType15
VertexType04 VertexType10 VertexType16
VertexType05 VertexType11 VertexType17
: KM_IMAGE_PARAM1 / KM_IMAGE_PARAM2 can be used. : Only KM_IMAGE_PARAM1 can be used.
Parameters:
pVertexBuffDesc(input/output)
        This parameter is a pointer to KMVERTEXBUFFDESC.

pTextureSurfaceDesc(input)
        This parameter is a pointer to KMSURFACEDESC.
Return values:
Value Explanation
KMSTATUS_SUCCESS Success