Legacy Document

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

noErr	0	No error
procNotFound	-600	Suspended process with specified process serial number doesn't exist