TracerRecord
Description:
protected TracerRecord ()
Create a new tracer record.
The record instance can be used to efficiently log entries using gst_tracer_record_log
. null
terminator required
after the last argument.
The name
without the ".class" suffix will be used for the log records. There must be fields for each value that gets logged where
the field name is the value name. The field must be a Structure describing the
value. The sub structure must contain a field called 'type' of typeof (
Type)
that contains the GType of the value. The resulting
TracerRecord will take ownership of the field structures.
The way to deal with optional values is to log an additional boolean before the optional field, that if true
signals that the
optional field is valid and false
signals that the optional field should be ignored. One must still log a placeholder value for the
optional field though. Please also note, that pointer type values must not be NULL - the underlying serialisation can not handle that right now.
> Please note that this is still under discussion and subject to change.
Parameters:
firstfield |
name of first field to set |
name |
name of new record, must end on ".class". |
... |
additional arguments |
Returns:
a new TracerRecord |