Structure representing a media time request to the clock component.

A client component sends this structure to the Clock Component via a SetConfig on its client port to specify a media timestamp the Clock Component should emit. The Clock Component should fulfill the request by sending a OMX_TIME_MEDIATIMETYPE when its media clock matches the requested timestamp.

The client may require a media time request be fulfilled slightly earlier than the media time specified. In this case the client specifies an offset which is equal to the difference between wall time corresponding to the requested media time and the wall time when it will be fulfilled.

A client component may uses these requests and the OMX_TIME_MEDIATIMETYPE to time events according to timestamps. If a client must perform an operation O at a time T (e.g. deliver a video frame at its corresponding timestamp), it makes a media time request at T (perhaps specifying an offset to ensure the request fulfillment is a little early). When the clock component passes the resulting OMX_TIME_MEDIATIMETYPE structure back to the client component, the client may perform operation O (perhaps having to wait a slight amount more time itself as specified by the return values).