Legacy Documentclose button

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

Previous Book Contents Book Index Next

Inside Macintosh: Processes
Chapter 2 - Process Manager / Process Manager Reference
Routines / Getting Process Information


WakeUpProcess

Use the WakeUpProcess function to make a process suspended by WaitNextEvent eligible to receive CPU time.

FUNCTION WakeUpProcess (PSN: ProcessSerialNumber): OSErr;
PSN
The process serial number of the process to be made eligible. This number should be a valid process serial number returned from LaunchApplication, GetNextProcess, GetFrontProcess, GetCurrentProcess, or a high-level event. You can also use the constant kCurrentProcess to refer to the current process.
DESCRIPTION
The WakeUpProcess function makes a process suspended by WaitNextEvent eligible to receive CPU time. A process is suspended when the value of the sleep parameter in the WaitNextEvent function is not 0 and no events for that process are pending in the event queue. This process remains suspended until the time specified in the sleep parameter expires or an event becomes available for that process. You can use WakeUpProcess to make the process eligible for execution before the time specified in the sleep parameter expires.

The WakeUpProcess function does not change the order of the processes scheduled for execution; it only makes the specified process eligible for execution.

ASSEMBLY-LANGUAGE INFORMATION
The trap macro and routine selector for the WakeUpProcess function are
Trap macro Selector
_OSDispatch$003C

RESULT CODES
noErr0No error
procNotFound-600Suspended process with specified process serial number doesn't exist


Previous Book Contents Book Index Next

© Apple Computer, Inc.
17 JUN 1996