DDI_INTR_GET_PENDING(9F) Kernel Functions for Drivers
NAME
ddi_intr_get_pending - get pending bit for a given interrupt
SYNOPSIS
#include <sys/types.h>
#include <sys/conf.h>
#include <sys/ddi.h>
#include <sys/sunddi.h>
int ddi_intr_get_pending(
ddi_intr_handle_t h,
int *pendingp);
INTERFACE LEVEL
illumos DDI specific (illumos DDI).
PARAMETERS
h DDI interrupt handle
pendingp Pointer to the pending capability returned for this
handle
DESCRIPTION
The
ddi_intr_get_pending() function returns non-zero as the integer
pointed to by the
pendingp argument if a corresponding interrupt is
pending. The corresponding interrupt handle
h must already be
allocated. The call succeeds if the device or host bridge supports
the ability to read the interrupt pending bits of its interrupts. The
driver should use
ddi_intr_get_cap() function to see if the
DDI_INTR_FLAG_PENDING flag is returned to indicate that interrupts
support interrupt pending bits.
If the
DDI_INTR_FLAG_PENDING capability is not supported,
ddi_intr_get_pending() returns
DDI_ENOTSUP and zero in
pendingp.
RETURN VALUES
The
ddi_intr_get_pending() function returns:
DDI_SUCCESS On success.
DDI_EINVAL On encountering invalid input parameters.
DDI_FAILURE On any implementation specific failure.
DDI_ENOTSUP On device not supporting operation.
CONTEXT
The
ddi_intr_get_pending() function can be called from either user or
kernel non-interrupt context.
ATTRIBUTES
See
attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Evolving |
+--------------------+-----------------+
SEE ALSO
attributes(7),
ddi_intr_block_disable(9F),
ddi_intr_block_enable(9F),
ddi_intr_clr_mask(9F),
ddi_intr_disable(9F),
ddi_intr_enable(9F),
ddi_intr_set_mask(9F) Writing Device DriversNOTES
Any consumer of this interface should verify that the return value is
not equal to
DDI_SUCCESS. Incomplete checking for failure codes could
result in inconsistent behavior among platforms.
April 7, 2005 DDI_INTR_GET_PENDING(9F)
