PK_PARTITION_make_pmark_2

PK_ERROR_code_t                    PK_PARTITION_make_pmark_2
(
--- received arguments ---
PK_PARTITION_t                     partition,
const PK_PARTITION_make_pmark_o_t *options,

--- returned arguments ---
PK_PMARK_t                  *const pmark,
int                         *const n_new,
PK_ENTITY_t                **const new_entities,
int                         *const n_mod,
PK_ENTITY_t                **const mod_entities,
int                         *const n_del,
int                        **const del_entities
)


This function creates a partition mark in the given partition.


Specific Errors:
    PK_ERROR_rollback_not_started  Partitioned rollback is not active (MILD)
    PK_ERROR_frustrum_failure      The frustrum reported a problem (MILD)
    PK_ERROR_bad_mark              A pmark may not be created (MILD)
    PK_ERROR_mesh_not_found        Not all requested mesh data successfully
                                   received (MILD)


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

A pmark may not be created if the partition is at its initial pmark.

This function should only be called when partitioned rollback has been started
with PK_DELTA_register_callbacks.

Further controls can be specified in 'options'.

The 'mod_entities' list is generated using internal data structure changes.  It
is not recommended for this list to be used in application tracking for the
following reasons:
    o Some changes (as perceived by the application) may not be present in the
      list.
    o Although all changed attributes ARE included in the list, some additional
      entries may also be present.