VISetPostRetraceCallback

C Specification

#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 that no callback is specified as a post-retrace callback. Similarly, NULL is returned when no callback is specified before. Since no callback is specified by default, the first call to this function should return NULL. You can cancel a callback you set previously by specifying NULL to callback.

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

See Also

VISetPreRetraceCallback, VIWaitForRetrace

Revision History

03/01/2006 Initial version.