osSpTaskYield

Syntax

#include <ultra64.h>
void osSpTaskLoad(OSTask *task);
s32 osSpTaskStartGo(OSTask *task);
s32 osSpTaskStart(OSTask *task);
s32 osSpTaskYield(void);
OSYieldResult osSpTaskYielded(OSTask *task);

Explanation
The osSpTaskLoad, osSpTaskStartGo, osSpTaskStart, osSpTaskYield, and osSpTaskYielded functions manage the signal processor (SP) "tasks" that can be invoked from the CPU host.

Tasks are embodied by an OSTask structure. Please see the OSTask page for information about that structure's members.

Following the completion of a task, the SP interrupts the CPU and generates an OS_EVENT_SP event. The application can associate a message queue with this event with the osSetEventMesg call. Furthermore, graphics task display lists should complete with a call to gDPFullSync to additionally cause the display processor (DP) to interrupt the CPU. The associated event for osSetEventMesg is OS_EVENT_DP.

The osSpTaskYield function requests that the SP yield. A yield is a premature stopping of a Graphics task at a point where it can be restarted. During a yield, the SP saves its state so that it can be restarted by calling osSpTaskStart. Currently, only graphics tasks can yield. Yielding is primarily used for pausing the graphics task so that an audio task can run when it needs to.

See Also
osSpTaskLoad
osSpTaskStartGo
osSpTaskStart
osSpTaskYielded

Nintendo® Confidential Warning: all information in this document is confidential and covered by a non-disclosure agreement. You are responsible for keeping this information confidential and protected. Nintendo will vigorously enforce this responsibility. Copyright © 1998 Nintendo of America Inc. All rights reserved Nintendo and N64 are registered trademarks of Nintendo Last updated March 1998