Sets contiguous pages of VRAM to a specified value.
Err SetVRAMPages (Item ioreq,void *dest,int32 value,int32 numpages,int32 mask)
This convenience routine allows one or more pages of VRAM, referred to by the dest argument, to be set to the specified value. The number of VRAM pages set is controlled by the numPages argument. Pages can be set to any value, using the immediate Flashwrite mode in the VRAM. As expected, it is very fast.
This call uses the SPORT device to do the transfer. It takes effect immediately; there is no implicit wait for the next VBlank to occur.
The call returns a non-negative value if successful or an error code (a negative value) if an error occurs.
The use of a mask value other than all 1s (0xFFFFFFFF) is discouraged. Future systems may not support this feature in a performance-conscious manner.
Convenience call implemented in graphics.lib V20.
graphics.h, graphics.lib
CloneVRAMPages
(), CopyVRAMPages(), SetVRAMPagesDefer(), CopyVRAMPagesDefer(), CloneVRAMPagesDefer(), GetVRAMIOReq()