Inside Macintosh: Processes

Chapter 5 - Notification Manager / Notification Manager Reference

Notification Manager Routines /

NMInstall

To install a notification request, use the NMInstall function.

FUNCTION NMInstall (nmReqPtr: NMRecPtr): OSErr;

nmReqPtr

A pointer to a notification record.

DESCRIPTION

The NMInstall function adds the notification request specified by the nmReqPtr parameter to the notification queue and returns a result code.

SPECIAL CONSIDERATIONS

Because NMInstall does not move or purge memory, you can call it from completion routines or interrupt handlers as well as from the main body of an application and from the response procedure of a notification request.

ASSEMBLY-LANGUAGE INFORMATION

The registers on entry and exit for NMInstall are

Registers on entry
A0	Address of NMRec record

Registers on exit
D0	Result code

RESULT CODES

noErr	0	No error
nmTypErr	-299	Invalid qType value (must be ORD(nmType))