Function safety
Function safety refers to whether or not it's safe to use the multimedia streaming server API functions in certain situations.
All QNX OpenMAX AL API functions are thread-safe and behave as documented even in a multithreaded environment, as long as no more than one thread uses the same explicit handle at the same time.
API functions are neither interrupt-safe nor signal-safe. Consequently, you shouldn't call them in an interrupt handler or signal handler.
For more information on how QNX defines function safety situations outside of the POSIX context, refer to the
What's in a Function Description?
section in the C Library Reference.
Classification:
| Safety | |
|---|---|
| Cancellation point | Read the Caveats |
| Interrupt handler | No |
| Signal handler | No |
| Thread | Yes |
Caveats:
Any multimedia streaming server API library function may contain a cancellation point. However, cancelling a thread while it's executing an API function can cause leaks or leave data structures in a bad state. If you need to call API functions from a thread that might be cancelled during the call or might already have a pending cancellation request, then disable cancellation for the duration of the call.
