PK_MARK_create

PK_ERROR_code_t  PK_MARK_create
(
--- returned arguments ---
PK_MARK_t *const mark              --- created mark
)


This function sets a rollmark and returns a mark identifier.


Specific Errors:
    PK_ERROR_rollback_not_started  Neither PK nor partitioned rollback active
                                   (MILD)
    PK_ERROR_frustrum_failure      The frustrum reported a problem (MILD)
    PK_ERROR_mesh_not_found        Not all requested mesh data successfully
                                   received (MILD)


This function creates a mark which represents the state of the modeller at
a moment in time.  By supplying this mark to PK_MARK_goto the application
can (with certain restrictions) return the modeller to that state.

If the modeller has already been rolled back, invocation of this function
invalidates all forward marks.

If partitioned rollback is active then pmarks will be created in all
partitions that are not currently at a pmark. These new pmarks are not
deleted when the mark is deleted by PK_MARK_delete.

This function should only be called when non-partitioned rollback has been
started with PK_MARK_start, or partitioned rollback has been started with
PK_DELTA_register_callbacks.