Sets contiguous pages of VRAM to a specified value.
Err SetVRAMPagesDefer (Item ioreq,void *dest,int32 val,int32 numpages,int32 mask)
This convenience call 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, via the immediate Flashwrite mode of the VRAM. As expected, it is very fast. SetVRAMPagesDefer()
does not issue a WaitIO()
on the I/O request. The calling task must issue the WaitIO()
before the I/O request can be reused.
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(), SetVRAMPages(), CopyVRAMPagesDefer(), CloneVRAMPagesDefer(), GetVRAMIOReq()