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
    PK_ERROR_frustrum_failure      The frustrum reported a problem


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.

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.