kmuCheckPassTable

Checks VERTEXCONTEXT


KMUPASSSTATUS KMAPI
kmuCheckPassTable(
IN PPKMVERTEXCONTEXT ppVertexContextTable,
IN KMUINT32 nNumContext,
OUT PKMUINT32 pPass
)

Description:

This function checks whether the content of each context in the specified VERTEXCONTEXT table is correct. The function is intended mainly for debugging when multiple passes are used.

Parameters:

ppVertexContextTable(input)
This parameter specifies a pointer to an array of pointers to the prepared VERTEXCONTEXT.

nNumContext(input)
This parameter specifies the entries (passes) in the prepared ppVertexContextTable.

pPass(output)
If an error is detected, KAMUI sets the invalid VERTEXCONTEXT in pPass. (If KMU_PASS_OK is returned, the contents of pPass will be undefined.)

Return values:

ValueExplanation
KMU_PASS_OKSuccess
KMU_PASS_ERROR_VERTEXCONTEXTInvalid (NULL) VertexContext
KMU_PASS_ERROR_VERTEXCONTEXT_PASS Invalid nNumContext (less than 1)
KMU_PASS_ERROR_PARAMTYPE Invalid parameter type
KMU_PASS_ERROR_LISTTYPE Invalid list type
KMU_PASS_ERROR_MIPMAP_D_ADJUST Invalid Mipmap_D_Adjust
KMU_PASS_ERROR_FOGMODE Invalid fog mode (for ARC1)
KMU_PASS_ERROR_FILTERMODE Invalid filter mode (for ARC1)
KMU_PASS_ERROR_TEXTURESHADINGMODE Invalid texture shading mode (for ARC1)
KMU_PASS_ERROR_COLORTYPE Invalid color type
KMU_PASS_ERROR_SHADINGMODE Invalid shading mode (for ARC1)
KMU_PASS_ERROR_USERCLIPMODE Invalid user clip mode
KMU_PASS_ERROR_TRILINEAR_SETTING Invalid combination of trilinear settings. Either ListType, ShadingMode, FilterMode, SRCBlendingMode, DSTBlendingMode, bSRCSel, or bDSTSel is set so that it cannot be used at Trilinear.
KMU_PASS_ERROR_SPRITE_SETTING Invalid combination of sprite settings. Either ShadingMode, ColorType, or UVFormat is set so that it cannot be used at Sprite.
KMU_PASS_ERROR_BLENDINGMODE_SETTING Invalid combination of blending settings. When opaque polygon is used, ( ListType = KM_OPAQUE_POLYGON ), a combination is specified so that it cannot be set at SRCBlendingMode and DSTBlendingMode.
KMU_PASS_ERROR_MODIFIER_SETTING Invalid combination of modifier settings. When modifier volume is used, (ParamType = KM_MODIFIERVOLUME), the ModifierInstruction setting is incorrect.

  kmuCheckPassTable