GXGetGPStatus

Syntax

#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 indicate whether the watermarks have been passed. If the CPU and GP FIFO are the same, overhi indicates whether the current GX thread is suspended.

The brkpt value can be used to determine if a break point is in progress. (In other words, during a break point the 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

2006/03/01 Initial version.