![]() |
Enqueue |
||||
Header: | OSUtils.h | Carbon status: | Supported | |
Adds elements directly to an operating-system queue or a queue that you create.
void Enqueue ( QElemPtr qElement, QHdrPtr qHeader );
A pointer to the queue element to add to a queue.
A pointer to a queue header.
The Enqueue function adds the queue element specified by the qElement parameter to the end of the queue specified by the qHeader parameter. The specified queue header is updated to reflect the new queue element.
For a description of the QElem record, see QElem; for a description of the QHdr record, see QHdr.
Because interrupt functions are likely to manipulate operating-system queues, interrupts are disabled for a short time while the specified queue is updated. You can call the Enqueue function at interrupt time. However, the Enqueue function is ordinarily used only by system software. Whenever possible, you should manipulate an operating-system queue indirectly, by calling special-purpose functions whenever possible, instead of the Enqueue function. You can use the Queue Utilities functions for directly manipulating queues that you create. Use the following functions instead of Enqueue:
Installs a slot-based VBL task. This function is available with the Vertical Retrace Manager.
Installs a system-based VBL task. This function is available with the Vertical Retrace Manager.
Adds a disk drive. This function is available with the Device Manager.
Installs an Event. This function is available with the Event manager.
Installs a deferred task. This function is available with the Memory Management Utilities.
Installs a slot interrupt task. This function is available with the Slot Manager.
Installs a Notification request. This function is available with the Notification Manager.
Installs a Sleep task. This function is available with the Power Manager.
Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.
© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)