finish_frame


Description:

public FlowReturn finish_frame (owned CodecFrame frame)

frame must have a valid encoded data buffer, whose metadata fields are then appropriately set according to frame data or no buffer at all if the frame should be dropped.

It is subsequently pushed downstream or provided to pre_push. In any case, the frame is considered finished and released.

If frame does not have a buffer attached, it will be dropped, and a QoS message will be posted on the bus. Events from frame will be pushed out immediately.

After calling this function the output buffer of the frame is to be considered read-only. This function will also change the metadata of the buffer.

Parameters:

this

a Encoder

frame

an encoded CodecFrame

Returns:

a FlowReturn resulting from sending data downstream