Changes PaletteBank.(KMVERTEXBUFFDESC Structure)

Prototype declaration:


KMSTATUS KMAPI
kmChangeContextPaletteBank(
        IN OUT  PKMVERTEXBUFFDESC   pVertexBuffDesc,
        IN      KMINT32             nParam,
        IN      KMDWORD             dwPaletteBank
);

Description:

This function changes the rendering parameter PaletteBank 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 by executing
kmChangeContextTextureSurface, if it is desired to change TextureSurface and PaletteBank,
execute kmChangeContextTextureSurface -> kmChangeContextPaletteBank, in that order.

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.

nParam(input)
        This parameter specifies the parameter for update.
            KM_IMAGE_PARAM1     parameter 1
            KM_IMAGE_PARAM2     parameter 2

dwPaletteBank(input)
        This parameter specifies the PaletteBank setting.(0-63)
Return values:
Value Explanation
KMSTATUS_SUCCESS Success