osGetIntMask, osSetIntMask
Gets/sets the enabled interrupt mask
#include <ultra64.h> /* ultra64.h */ OSIntMask osGetIntMask(void); OSIntMask osSetIntMask(OSIntMask im);
The osGetIntMask and osSetIntMask functions get and set enabled interrupt masks. The osGetIntMask call returns the mask of currently enabled hardware interrupts, and the osSetIntMask call allows the application to enable and disable interrupts based on the provided mask. Following are the bits of the mask. The interrupt is enabled if the associated definition below is bitwise OR'ed into the final mask.
| OS_IM_SW1 | : CPU software interrupt 1 |
| OS_IM_SW2 | : CPU software interrupt 2 |
| OS_IM_CART | : Pak interrupt |
| OS_IM_PRENMI | : Pre-NMI interrupt |
| OS_IM_COUNTER | : CPU timer interrupt |
| OS_IM_SP | : RCP Signal Processor (SP) interrupt |
| OS_IM_SI | : RCP Serial Interface (SI) interrupt |
| OS_IM_AI | : RCP Audio Interface (AI) interrupt |
| OS_IM_VI | : RCP Video Interface (VI) interrupt |
| OS_IM_PI | : RCP Parallel Interface (PI) interrupt |
| OS_IM_DP | : RCP Display Processor (DP) interrupt |
| OS_IM_NONE | : No interrupts enabled |
| OS_IM_ALL | : All interrupts enabled |
The interrupt mask is part of the thread context and is thus saved and restored as threads yield and regain the CPU. All interrupts are enabled for the thread at creation time by osCreateThread. These routines are used sparingly by system threads and should not be needed by application threads. Instead, applications should exploit thread priorities for real time behavior and protection of critical regions.
1999/04/30 Changed Format