* #tdm_client_vblank_wait will return TDM_ERROR_NONE as success if
* #tdm_client_vblank_set_enable_fake sets true. Once #tdm_client_vblank_wait
* returns TDM_ERROR_NONE, the user client vblank handler(#tdm_client_vblank_handler)
- * SHOULD be called after the given interval.
+ * SHOULD be called after the given interval. \n
+ * The sequence value of tdm_client_vblank_handler is the relative value of fps.
+ * If fps = 10, this sequence value should be increased by 10 during 1 second.
* @param[in] vblank The client vblank object
* @param[in] interval The vblank interval
* @param[in] func The user client vblank handler
tdm_error
tdm_client_vblank_wait(tdm_client_vblank *vblank, unsigned int interval, tdm_client_vblank_handler func, void *user_data);
+/**
+ * @brief Wait for a vblank with the target sequence number
+ * @details
+ * This function will return TDM_ERROR_DPMS_OFF when DPMS off. However,
+ * #tdm_client_vblank_wait will return TDM_ERROR_NONE as success if
+ * #tdm_client_vblank_set_enable_fake sets true. Once #tdm_client_vblank_wait_seq
+ * returns TDM_ERROR_NONE, the user client vblank handler(#tdm_client_vblank_handler)
+ * SHOULD be called on reaching the target sequence.
+ * @param[in] vblank The client vblank object
+ * @param[in] sequence The target sequence number
+ * @param[in] func The user client vblank handler
+ * @param[in] user_data The user data
+ * @return #TDM_ERROR_NONE if success. Otherwise, error value.
+ */
+tdm_error
+tdm_client_vblank_wait_seq(tdm_client_vblank *vblank, unsigned int sequence, tdm_client_vblank_handler func, void *user_data);
#ifdef __cplusplus
}