Expire a promise. This will wake up any waiters with gst.types.PromiseResult.Expired. Called by a message loop when the parent message is handled and/or destroyed (possibly unanswered).
Retrieve the reply set on promise. promise must be in gst.types.PromiseResult.Replied and the returned structure is owned by promise
Interrupt waiting for a promise. This will wake up any waiters with gst.types.PromiseResult.Interrupted. Called when the consumer does not want the value produced anymore.
Set a reply on promise. This will wake up any waiters with gst.types.PromiseResult.Replied. Called by the producer of the value to indicate success (or failure).
Wait for promise to move out of the gst.types.PromiseResult.Pending state. If promise is not in gst.types.PromiseResult.Pending then it will return immediately with the current result.
func will be called exactly once when transitioning out of gst.types.PromiseResult.Pending into any of the other #GstPromiseResult states.
Pointer to the C boxed value
Get the GType of this boxed type.
Boxed GType property.
Convenience method to return this cast to a type. For use in D with statements.
Make a copy of the wrapped C boxed data.
Copy a C boxed value using g_boxed_copy.
Free a C boxed value using g_boxed_free.
The #GstPromise object implements the container for values that may be available later. i.e. a Future or a Promise in <https://en.wikipedia.org/wiki/Futures_and_promises>. As with all Future/Promise-like functionality, there is the concept of the producer of the value and the consumer of the value.
A #GstPromise is created with gst.promise.Promise.new_ by the consumer and passed to the producer to avoid thread safety issues with the change callback. A #GstPromise can be replied to with a value (or an error) by the producer with gst.promise.Promise.reply. The exact value returned is defined by the API contract of the producer and null may be a valid reply. gst.promise.Promise.interrupt is for the consumer to indicate to the producer that the value is not needed anymore and producing that value can stop. The @GST_PROMISE_RESULT_EXPIRED state set by a call to gst.promise.Promise.expire indicates to the consumer that a value will never be produced and is intended to be called by a third party that implements some notion of message handling such as #GstBus. A callback can also be installed at #GstPromise creation for result changes with gst.promise.Promise.newWithChangeFunc. The change callback can be used to chain #GstPromises's together as in the following example.
Each #GstPromise starts out with a #GstPromiseResult of gst.types.PromiseResult.Pending and only ever transitions once into one of the other #GstPromiseResult's.
In order to support multi-threaded code, gst.promise.Promise.reply, gst.promise.Promise.interrupt and gst.promise.Promise.expire may all be from different threads with some restrictions and the final result of the promise is whichever call is made first. There are two restrictions on ordering:
1. That gst.promise.Promise.reply and gst.promise.Promise.interrupt cannot be called after gst.promise.Promise.expire 2. That gst.promise.Promise.reply and gst.promise.Promise.interrupt cannot be called twice.
The change function set with gst.promise.Promise.newWithChangeFunc is called directly from either the gst.promise.Promise.reply, gst.promise.Promise.interrupt or gst.promise.Promise.expire and can be called from an arbitrary thread. #GstPromise using APIs can restrict this to a single thread or a subset of threads but that is entirely up to the API that uses #GstPromise.