[hwc] add the ability to ask a client(E20) about the revalidation

[platform/core/uifw/libtdm.git] / include / tdm.h

diff --git a/include/tdm.h b/include/tdm.h
index b7fb89e..50fe717 100644 (file)
--- a/include/tdm.h
+++ b/include/tdm.h
@@ -635,6 +635,22 @@ tdm_error
 tdm_output_validate(tdm_output *output, uint32_t *num_types);
 
 /**
+ * @brief Set the 'need to validate' handler for the 'output'
+ *
+ * @details During backend's work it may need to ask for the revalidation
+ * (make client (E20) do tdm_output_validate() again), so a 'hndl' will
+ * be called as such need happen. Only one handler per output is supported.
+ *
+ * @param[in] output The output object a hndl is going to be registered for.
+ * @param[in] hndl The handler which will be called on the 'need to validate' event.
+ *
+ * @return #TDM_ERROR_NONE if success. Otherwise, error value.
+ */
+tdm_error
+tdm_output_set_need_validate_handler(tdm_output *output,
+               tdm_output_need_validate_handler hndl);
+
+/**
  * @brief Get changed composition types
  * @details Retrieves the windows for which the device requires a different
  * composition type than had been set prior to the last call to tdm_output_validate().