Summary
Yield the CPU of the current thread back to the scheduler.
Declaration
#include <zircon/syscalls.h>
zx_status_t zx_thread_legacy_yield(uint32_t options);
Description
zx_thread_legacy_yield()
causes the calling thread to yield the CPU back to the scheduler.
Yield may result in other threads with similar importance running ahead of the current thread, however, the exact behavior is unspecified.
options
must be zero.
Rights
TODO(https://fxbug.dev/42107318)
Return value
zx_thread_legacy_yield(uint32_t options)
will always return ZX_OK
for zero options
.
Any other options
value, will result in ZX_ERR_INVALID_ARGS
.