N64 Functions Menu -

al - Audio Library Functions
gDP - DP GBI Macros
gdSP - General GBI Macros
gSP - SP GBI Macros
gt - Turbo Microcode RDP
gu - Graphics Utilities
Math - Math Functions
nuSys - NuSystem
os - N64 Operating System
sp - Sprite Library Functions
uh - Host to Target IO
64DD - N64 Disk Drive

Nintendo® Confidential

   

osSpTaskYield

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


What These Functions Do
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 January 1998