Legacy Document

Important: The information in this document is obsolete and should not be used for new development.

Chapter 4 - Vertical Retrace Manager / Vertical Retrace Manager Reference

Vertical Retrace Manager Routines / System-Based Installation and Removal Routines

VRemove
You can use the VRemove function to remove a task record from the system-based vertical retrace queue.
FUNCTION VRemove (vblTaskPtr: QElemPtr): OSErr;
vblTaskPtr
A pointer to the task record to remove from the queue.

DESCRIPTION
The VRemove function removes the task record specified by the vblTaskPtr parameter from the system-based vertical retrace queue.
To disable a system-based VBL task temporarily, you can set the vblCount field of the task record to 0.

ASSEMBLY-LANGUAGE INFORMATION
The registers on entry and exit for VRemove are
Registers on entry
A0 Pointer to the task record

Registers on exit
D0 Result code

RESULT CODES
noErr 0 No error
qErr -1 Task record isn't in the queue
vTypErr -2 Invalid qType value (must be ORD(vType))

noErr	0	No error
qErr	-1	Task record isn't in the queue
vTypErr	-2	Invalid `qType` value (must be `ORD(vType)`)

Legacy Document

VRemove

DESCRIPTION

ASSEMBLY-LANGUAGE INFORMATION

RESULT CODES noErr0No error qErr-1Task record isn't in the queue vTypErr-2Invalid qType value (must be ORD(vType))

RESULT CODES
noErr 0 No error
qErr -1 Task record isn't in the queue
vTypErr -2 Invalid `qType` value (must be `ORD(vType)`)