 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 DriveNintendo® Confidential |
|
|
|
|
|
osSpTaskYielded
Format#include <ultra64.h>
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 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 January 1998 |