User Tools

Site Tools


solaris:ddi_intr_get_pending.9f

ddi_intr_get_pending


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

Solaris DDI specific (Solaris 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 enabled. 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:

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 Drivers in Oracle Solaris 11.4

NOTES

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.


solaris/ddi_intr_get_pending.9f.txt · Last modified: 2023/07/19 08:57 by A User Not Logged in