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

## osSpTaskYielded

Syntax

#include <ultra64.h>
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 osSpTaskYielded function must be called after requesting a yield to ensure the proper state of the task structure. It returns OS_TASK_YIELDED if the task successfully yielded. Otherwise, it returns 0, which indicates that the task finished normally before it could yield (and therefore should not be restarted later).
See Also
osSpTaskLoad
osSpTaskStartGo
osSpTaskStart
osSpTaskYield

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