#include <revolution/gx.h> GXBool GXGetCPUFifo( GXFifoObj* fifo );
| fifo | Pointer to the FIFO structure. |
|---|
Returns GX_TRUE if the FIFO status could be obtained; otherwise, returns GX_FALSE.
Gets the current CPU FIFO state in the structure object specified by fifo. This function returns GX_TRUE if the status was correctly obtained. Otherwise, it returns GX_FALSE if the status could not be obtained because the CPU FIFO had not been set.
Note: In contrast to the function of the same name in the Nintendo GameCube SDK, this function directly gets the current state of the CPU FIFO that is being used. (With the Nintendo GameCube SDK, only a pointer to the GXFifoObj structure previously set by the GXSetCPUFifo function was returned.
In addition, beginning from SDK 3.1 patch 3, specifications have changed so that the write-gather buffer inside the function is not flushed. You must call the GXFlush function, or a function that internally calls that function, at least once between the time that the last command enters the FIFO and the time the GXGetCPUFifo function is called. If these functions are not called, there is a possibility that problems may arise such as the screen remaining blacked out.
The following functions internally call the GXFlush function.
GXAbortFrame
GXSetDrawSync
GXSetDrawDone
GXDrawDone
GXBeginDisplayList
GXEndDisplayList
GXReadClksPerVtx
GXRedirectWriteGatherPipe
2008/09/04 Revised notes about changes to this function in SDK 3.1 patch 3 and subsequent versions.
2008/05/12 Added notes about changes to this function in SDK 3.1 patch 3 and subsequent versions.
2007/03/05 Added a note about the difference from the Nintendo GameCube SDK.
2006/09/22 Corrected typo in the argument name.
2006/03/01 Initial version.
CONFIDENTIAL