PATH ADC Home > Documentation > Hardware > Device Managers and Drivers > PCI Card Services > Designing PCI Cards and Drivers for Power Macintosh Computers

  

SetInterruptTimer

OSStatus SetInterruptTimer (
                     const AbsoluteTime *expirationTime,
                     SecondaryInterruptHandler2 handler,
                     void *p1,
                     TimerID *timer);
--> expirationTime
Time when the timer expires.
--> handler
Address of a secondary interrupt handler.
--> p1
First parameter to be passed to handler.
<-- timer
Timer ID.
DESCRIPTION

The parameter expirationTime is the current time plus the amount of time delay before calling the interrupt handler, expressed in AbsoluteTime units.

Parameter handler is the address of a secondary interrupt handler that is to be run when the specified time is reached.

Parameter p1 is the value that is passed as the first parameter to the secondary interrupt handler when the timer expires. The value of the second parameter passed to the secondary interrupt handler is set to the current program counter at the time the timer expired.

Parameter timer is updated with the ID of the timer that is created. This ID may be used in conjunction with CancelTimer.

IMPORTANT

If you use SetInterruptTimer in your code, you must provide a copy of System Enabler version 1.0.1 to Power Macintosh 9500 users who have Enabler version 1.0. If Enabler version 1.0.1 or later is already installed, the installer should not replace it. Only the Power Macintosh 9500 has a problem with SetInterruptTimer, and it occurs on only a few early units. Other Power Macintosh models are not affected. For further information, see the folder "New 9500 Enabler" in the PCI Device Driver Kit.

EXECUTION CONTEXT

SetInterruptTimer may be called from task level, secondary interrupt level, or hardware interrupt level.

RETURN CODE
noErr 0 No error
© 1999 Apple Computer, Inc. – (Last Updated 26 March 99)