GXSetDrawSyncCallback

Syntax

#include <revolution/gx.h>

typedef void (*GXDrawSyncCallback)(u16 token);

GXDrawSyncCallback GXSetDrawSyncCallback( GXDrawSyncCallback cb );

Arguments

cb	The callback called when a drawing synchronization token appears in the graphics pipeline.

Return Values

Returns a pointer to a previously set callback function.

Description

This function installs a callback that is invoked whenever a DrawSync token is encountered by the graphics pipeline. The callback's argument is the value of the most recently encountered token. Because it is possible to miss tokens (graphics processing does not stop while the callback is running), your code should be capable of deducing if any tokens have been missed (e.g. by using monotonically increasing values).

The callback will be invoked with interrupts disabled, so it is imperative that it return as quickly as possible.

Revision History

2006/03/01 Initial version.