VISetPostRetraceCallback

Syntax

#include <revolution/vi.h>

typedef void (*VIRetraceCallback)(u32 retraceCount);

VIRetraceCallback VISetPostRetraceCallback(VIRetraceCallback callback);

Arguments

callback A pointer to the post-retrace callback function.

Return Values

Pointer to the previous callback function.

Description

This function sets the post-retrace callback. That callback is a function called after the VI device driver's retrace interrupt handler sets the VI registers.

It returns the pointer to the previous callback function.

Specifying NULL for callback means no callback is specified as the post-retrace callback. Similarly, NULL is returned when no callback has been registered before. Since no callback is specified by default, the first call to this function should return NULL. You can cancel a callback function you set previously by specifying NULL for callback.

The retrace count, which is passed to the callback function as an argument, is incremented once every 1/60 second in NTSC/EURGB60 modes (or once every 1/50 second in PAL mode).

See Also

VISetPreRetraceCallback, VIWaitForRetrace

Revision History

2007/12/03 Deleted the MPAL description.
2006/03/01 Initial version.

CONFIDENTIAL