|
|
|
Allows the user to change the interrupt handler state of one or more
asynchronous ports. The caller of this routine must be the receiver of the
port.
Syntax
REC I32A BA BA
AIFPORTINT ( overall_status, port_list, newstates, oldstates );
Parameters
- overall_status
- record by reference (required)
Returns the overall status of the call. A zero indicates a successful
call. A negative value indicates an error in the overall call. A
positive value indicates a warning. Refer to appendix A for meanings of
status values.
Record type: status_type (Refer to appendix B.)
- port_list
- 32-bit signed integer array by reference (required)
Passes an array of integers that contain a list of port IDs whose
handlers will be enabled or disabled. This array MUST be terminated with
a zero. Each port ID must be an asynchronous port that has been created
by the caller. If any port ID is invalid, then NONE of the ports will
have their interrupt state changed.
- newstates
- Boolean array by reference (required)
An array of Booleans that specify the new port interrupt handling states
that are the result of this call. A value of TRUE enables interrupt
handling for the corresponding port ID in the port_list,
while FALSE disables interrupt handling on a port. This array must
contain as many elements as are contained in
port_list.
- oldstates
- Boolean array by reference (optional)
An array of booleans, that upon return from a successful call contains a
value of TRUE for each port in port_list that had
interrupts enabled prior to this call, and FALSE for each port that had
interrupts disabled. This array must contain as many elements as are
contained in port_list. If the call fails because of an
invalid port ID and this array was passed, a value of FALSE is returned
for each port that was not previously created by the caller.
Default: nil
Operation Notes
The AIFPORTINT routine has been provided to allow a user to enable or
disable interrupt handling when a message arrives on an AIF port. When
interrupt handling is disabled on a port, calls to the interrupt handling
routine are delayed until interrupt handling is reenabled with the
AIFPORTINT routine.
|
