OSTask Structure

• t.type - Task type. It should be initialized to M_AUDTASK for audio tasks or M_GFXTASK for graphics tasks.
• t.flags - Various task state bits. OS_TASK_DP_WAIT is the most important flag. When this flag is set, the boot microcode waits for the RDP to drain its current command stream before continuing. This is necessary if you are going to use the XBUS or switch the RDP input stream. However, do not set this flag for audio tasks or "_fifo" versions of graphics tasks.
• t.ucode_boot - Pointer to boot microcode. It should be initialized to rspbootTextStart.
• t_ucode_boot_size - Pointer to boot microcode size in bytes. It should be initialized to ((u32)rspbootTextEnd - (u32)rspbootTextStart).
• t.ucode - Pointer to task microcode. It should be set to aspMainTextStart for audio tasks or one of the following for graphics tasks:
  
  
  • gspFast3DTextStart
  • gspFast3D_dramTextStart
  • gspFast3D_fifoTextStart
  • gspLine3DTextStart
  • gspLine3D_dramTextStart
  • gspLine3D_fifoTextStart
  
  
• t.ucode_size - Size of microcode. It should be initialized to SP_UCODE_SIZE.
• t.ucode_data - Pointer to task microcode. It should be set to aspMainDataStart for audio tasks or one of the following for graphics tasks:
  
  
  • gspFast3DDataStart
  • gspFast3D_dramDataStart
  • gspFast3D_fifoDataStart
  • gspLine3DDataStart
  • gspLine3D_dramDataStart
  • gspLine3D_fifoDataStart
  
  
• t.ucode_data_size - Size of microcode data. It should be initialized to SP_UCODE_DATA_SIZE.
• t.dram_stack - Pointer to DRAM matrix stack. It should be initialized to 0 for audio tasks and to a memory region of size SP_DRAM_STACK_SIZE8 bytes for graphics tasks.
• t.dram_stack_size - DRAM matrix stack size in bytes. It should be initialized to 0 for audio tasks or SP_DRAM_STACK_SIZE8 for graphics tasks.
• t.output_buff - Pointer to output buffer. The "_dram" and "_fifo" versions of the graphics microcode will route the SP output to DRAM rather than to the DP. When this microcode is used, this should point to a memory region to which the SP will write the DP command list. For "_dram" versions of the microcode the buffer must be as long or longer than the DP data stream that will be generated by the RSP. The "_fifo" versions of the microcode require a buffer of at least 0x100 bytes, although larger buffers may provide greater performance.
• t.output_buff_size - For the "_dram" version of the microcode this is a *POINTER* to a N64 where the output buffer length will go. The SP will write the size of the DP command list in bytes to this location. For the "_fifo" version of the microcode this is a *POINTER* the byte following the last byte in the output buffer. The other microcodes (other than "_dram" and "_fifo") ignore the t.output_buff_size field.
• t.data_ptr - SP command list pointer. For graphics tasks, this is the application constructed display list. For audio tasks, this command list is created by alAudioFrame.
• t.data_size - Length of SP command list in bytes.
• t.yield_data_ptr - Pointer to buffer to store saved state of yielding task. If the application is going to support preemption of graphics tasks, the graphics tasks should have this structure member set. This should point to a memory region of size OS_YIELD_DATA_SIZE bytes. If task preemption is not supported by the application, this field should be initialized to 0. Audio tasks should always set this field to 0.
• t.yield_data_size - Size of yield buffer in bytes. When task yielding is to be supported by the application, this should be initialized to OS_YIELD_DATA_SIZE for the graphics task. Audio tasks should set this field to 0.

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