InstallInterruptFunctions11

InstallInterruptFunctions

The InstallInterruptFunctions function installs interrupt service routines in an interrupt member.

OSStatus InstallInterruptFunctions (
                     InterruptSetID setID,
                     InterruptMemberNumber member,
                     void *refCon,
                     InterruptHandler handlerFunction,
                     InterruptEnabler enableFunction,
                     InterruptDisabler disableFunction);

--> setID

Interrupt set ID of the IST member to be installed.

--> member

Set member number of the IST member to be installed.

<-- refCon

32-bit reference constant to be registered with the IST member.

--> handlerFunction

Pointer to interrupt service routine (ISR).

--> enableFunction

Pointer to interrupt enabler routine (IER).

--> disableFunction

Pointer to interrupt disabler routine (IDR).

DESCRIPTION

Given the ID of an interrupt set in the interrupt tree and the number of a member in that set, InstallInterruptFunctions installs the designated interrupt handler, enabler, and disabler routines. Interrupt sets and the interrupt tree are discussed in Interrupt Management.

Parameter refCon can be any 32-bit value. Mac OS does not use it; it is merely stored and passed to each invocation of the most recently installed ISR routine. Placing nil in a handlerFunction, enableFunction, or disableFunction parameter will not install a new routine--it will leave the current routine installed.

InstallInterruptFunctions returns noErr if the installation succeeded.

EXECUTION CONTEXT

InstallInterruptFunctions may be called only from task level, not from secondary or hardware interrupt level.

RESULT CODES

`noErr`	0	No error
`paramErr`	-50	Bad parameter