zx_interrupt_ack

SUMMARY

Acknowledge an interrupt and re-arm it.

DECLARATION

#include <zircon/syscalls.h>

zx_status_t zx_interrupt_ack(zx_handle_t handle);

DESCRIPTION

zx_interrupt_ack() acknowledges an interrupt object, causing it to be eligible to trigger again (and delivering a packet to the port it is bound to).

If the interrupt object is a physical interrupt, if it is a level interrupt and still asserted, or is an edge interrupt that has been asserted since it last triggered, the interrupt will trigger immediately, delivering a packet to the port it is bound to.

Virtual interrupts behave as edge interrupts.

This syscall only operates on interrupts bound to a port. Interrupts being waited upon with [zx_interrupt_wait()] do not need to be re-armed with this call -- it happens automatically when [zx_interrupt_wait()] is called.

RIGHTS

handle must be of type ZX_OBJ_TYPE_INTERRUPT and have ZX_RIGHT_WRITE.

RETURN VALUE

zx_interrupt_ack() returns ZX_OK on success. In the event of failure, a negative error value is returned.

ERRORS

ZX_ERR_BAD_HANDLE handle is an invalid handle.

ZX_ERR_WRONG_TYPE handle is not an interrupt object.

ZX_ERR_BAD_STATE handle is not bound to a port.

ZX_ERR_CANCELED [zx_interrupt_destroy()] was called on handle.

ZX_ERR_ACCESS_DENIED handle lacks ZX_RIGHT_WRITE.