GXGetGPStatus

C Specification

#include <revolution/gx.h>

void GXGetGPStatus(
GXBool* overhi,
GXBool* underlow,
GXBool* readIdle,
GXBool* cmdIdle,
GXBool* brkpt );

Arguments

`overhi`	GX_TRUE if high watermark has been passed.
`underlow`	GX_TRUE if low watermark has been passed.
`readIdle`	GX_TRUE if the GP read unit is idle.
`cmdIdle`	GX_TRUE if all commands have been flushed to XF.
`brkpt`	`GX_TRUE` if FIFO has reached a breakpoint and GP reads have been stopped.

Return Values

None.

Description

Reads the current state of the GP.

overhi and underlow indicates whether the watermark has been reached. If the CPU and GP FIFO are the same, overhi indicates whether the current GX thread is suspended.

The brkpt can be used to determine if the break point is in progress (in other words, reading of GP is suspended. It is resumed by calling the GXDisableBreakPt function.) A callback can also be used to notify the application when a breakpoint has been reached. (See the GXSetBreakPtCallback function.)

Revision History