Function dart_sys::Dart_RecordTimelineEvent

pub unsafe extern "C" fn Dart_RecordTimelineEvent(
    label: *const c_char,
    timestamp0: i64,
    timestamp1_or_id: i64,
    flow_id_count: isize,
    flow_ids: *const i64,
    type_: Dart_Timeline_Event_Type,
    argument_count: isize,
    argument_names: *mut *const c_char,
    argument_values: *mut *const c_char
)

Add a timeline event to the embedder stream.

Note regarding flow events: events must be associated with flow IDs in two different ways to allow flow events to be serialized correctly in both Chrome’s JSON trace event format and Perfetto’s proto trace format. Events of type |Dart_Timeline_Event_Flow_Begin|, |Dart_Timeline_Event_Flow_Step|, and |Dart_Timeline_Event_Flow_End| must be reported to support serialization in Chrome’s trace format. The |flow_ids| argument must be supplied when reporting events of type |Dart_Timeline_Event_Begin|, |Dart_Timeline_Event_Duration|, |Dart_Timeline_Event_Instant|, |Dart_Timeline_Event_Async_Begin|, and |Dart_Timeline_Event_Async_Instant| to support serialization in Perfetto’s proto format.

\param label The name of the event. Its lifetime must extend at least until Dart_Cleanup. \param timestamp0 The first timestamp of the event. \param timestamp1_or_id When reporting an event of type |Dart_Timeline_Event_Duration|, the second (end) timestamp of the event should be passed through |timestamp1_or_id|. When reporting an event of type |Dart_Timeline_Event_Async_Begin|, |Dart_Timeline_Event_Async_End|, or |Dart_Timeline_Event_Async_Instant|, the async ID associated with the event should be passed through |timestamp1_or_id|. When reporting an event of type |Dart_Timeline_Event_Flow_Begin|, |Dart_Timeline_Event_Flow_Step|, or |Dart_Timeline_Event_Flow_End|, the flow ID associated with the event should be passed through |timestamp1_or_id|. When reporting an event of type |Dart_Timeline_Event_Begin| or |Dart_Timeline_Event_End|, the event ID associated with the event should be passed through |timestamp1_or_id|. Note that this event ID will only be used by the MacOS recorder. The argument to |timestamp1_or_id| will not be used when reporting events of other types. \param flow_id_count The number of flow IDs associated with this event. \param flow_ids An array of flow IDs associated with this event. The array may be reclaimed when this call returns. \param argument_count The number of argument names and values. \param argument_names An array of names of the arguments. The lifetime of the names must extend at least until Dart_Cleanup. The array may be reclaimed when this call returns. \param argument_values An array of values of the arguments. The values and the array may be reclaimed when this call returns.