FDMI source record struct. Used to keep data, associated to FDMI src record.
Is also used to pass the record over between source and source dock. On this communication, a pointer to this struct is uniquely identifying the record being processed.
FDMI source is responsible for allocating it, and filling in the following fields:
The rest of fields are populated by source dock. The key ones are filled in at post_record call, the rest – during record processing. FDMI source dock will keeps here all the information on FDMI record that is being processed (or being sent to plugin).
FDMI source is also responsible for de-allocating the struct, but only after source dock calls fs_put for the last time.
One recommended way of using this structure is to incorporate it into whatever struct that keeps actual data/descriptor of the event/object which has caused this FDMI record to come into existence. Later on, whenever src dock will require actions on the record, the source can easily obtain the ptr to ambient structure and use it, no need for any look-ups.
Definition at line 66 of file src_rec.h.