set_state

Sets the state of the element.

This function will try to set the requested state by going through all the intermediary states and calling the class's state change function for each.

This function can return ASYNC, in which case the element will perform the remainder of the state change asynchronously in another thread. An application can use get_state to wait for the completion of the state change or it can wait for a gst_message_async_done or gst_message_state_changed on the bus.

State changes to gst_state_ready or gst_state_null never return ASYNC.

Parameters:

this	a Element to change state of.
state	the element's new State.

Returns:

Result of the state change using StateChangeReturn. MT safe.