- * Send a request to the deviced for changing power state. It doesn't ensure the whole execution
- * of a callback subroutine - think of a request for sleep/poweroff/reboot state. To ensure
- * the whole execution of a callback, use device_power_add_change_state_wait_callback() additionally.
- * If both change_state_wait_callback and change_state_callback has registered to a state,
- * it is unpredictable which callback will be invoked first.
- *
- * uint64_t state: which state to transition to
- * int timeout_sec: maximum timeout of async method call. if it expires, then the second parameter of
- * a callback function, int retval, gives -ETIMEDOUT error. If it is 0 or negative, it is set to
- * the default, 10 seconds.
- * change_state_callback cb: async callback function, nullable
- * void *user_data: user data for the callback.
+ * @brief Send request for changing power state asynchronously.
+ * @since_tizen 6.5
+ * @param[in] state Target state
+ * @param[in] timeout_sec Timeout for the async reply in second, maximum of 10 seconds
+ * @param[in] cb Async callback of the request
+ * @param[in] user_data Data to be passed to the callback function
+ * @return 0 on success,
+ * otherwise a negative error value
+ * @retval #DEVICE_ERROR_NONE Successful
+ * @retval #DEVICE_ERROR_OPERATION_FAILED Operation failed