Carbon


DMRegisterExtendedNotifyProc

Header: Displays.h Carbon status: Modified

Registers a function that responds to a Display Notice event outside of an event loop.

OSErr DMRegisterExtendedNotifyProc (
    DMExtendedNotificationUPP notifyProc, 
    void *notifyUserData, 
    UInt16 nofifyOnFlags, 
    ProcessSerialNumberPtr whichPSN
);
Parameter descriptions
notifyProc

A pointer to your function that handles a Display Notice event.

notifyUserData

A pointer to caller-specific information which the Display Manager will return to your application when you request it.

nofifyOnFlags

Reserved for future expansion. Pass NULL in this parameter.

whichPSN

A pointer to the Process Serial Number associated with your Display Notice event-handling function. If this process terminates, the Display Notice event-handling function is automatically removed. For example, the Monitors control panel supplies the Finder’s process number when registering its Display Notice event-handling function.

function result

A result code.

DISCUSSION

When the Display Manager sends your function the Display Notice event, your application or utility should respond by moving or resizing its windows and updating any internally-maintained video device information as appropriate.

When you are finished with your notification function, remove it by calling DMRemoveExtendedNotifyProc.

SPECIAL CONSIDERATIONS

Because this function may move or purge memory blocks or access handles, you cannot call it at interrupt time.

AVAILABILITY

Modified in Carbon. Available in Carbon 1.0.2 and later when Displays 2.0 or later is present.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)