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

CreateSoftwareInterrupt



 
OSStatus CreateSoftwareInterrupt(

                     SoftwareInterruptHandlerhandler,

                     TaskID task,

                     const void *p1,

                     Boolean persistent,

                     SoftwareInterruptID *softwareInterrupt)

--> handler: Handler for the new software interrupt.
--> task: Task ID.
--> p1: First parameter to be passed to the handler.
--> persistent: Indicates whether the ID of the software interrupt should be deleted when it is activated or should persist until deleted by DeleteSoftwareInterrupt.
--> theSoftwareInterrupt: Software interrupt ID.

DESCRIPTION

CreateSoftwareInterrupt creates a software interrupt for a specified task. It can be called either from noninterrupt or secondary execution level.

Persistent software interrupts may be sent multiple times but only once per activation; that is, the software interrupt must run before it can be sent again.

EXECUTION CONTEXT

CreateSoftwareInterrupt may be called from task level or secondary interrupt level but not from hardware interrupt level.

RESULT CODES

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