总结
创建一个中断对象。
声明
#include <zircon/syscalls.h>
zx_status_t zx_interrupt_create(zx_handle_t src_obj,
uint32_t src_num,
uint32_t options,
zx_handle_t* out_handle);
说明
zx_interrupt_create()
会创建一个代表物理中断或虚拟中断的中断对象。
如果 options 为 ZX_INTERRUPT_VIRTUAL
,则 src_obj 和 src_num 会被忽略,并返回虚拟中断。
否则,src_obj 必须是用于创建平台中断或 PCI 对象的合适资源,src_num 是关联的中断编号。这会限制对 DDK(驱动程序开发套件)内部的中断创建。物理中断由驱动程序通过各种 DDK API 获取。
物理中断支持 ZX_INTERRUPT_EDGE_LOW
、ZX_INTERRUPT_EDGE_HIGH
、ZX_INTERRUPT_LEVEL_LOW
、ZX_INTERRUPT_LEVEL_HIGH
和 ZX_INTERRUPT_REMAP_IRQ
选项。
句柄将有 ZX_RIGHT_INSPECT
、ZX_RIGHT_DUPLICATE
、ZX_RIGHT_TRANSFER
(允许通过 zx_channel_write()
将其发送到其他进程)、ZX_RIGHT_READ
、ZX_RIGHT_WRITE
(对于 zx_interrupt_ack()
是必需的)、ZX_RIGHT_WAIT
(对 zx_interrupt_wait()
和 ZX_RIGHT_SIGNAL
是必需的(对 zx_interrupt_trigger()
是必需的)。
当发生底层物理中断或对虚拟中断调用 zx_interrupt_trigger()
时,中断称为“已触发”。当通过 zx_interrupt_bind()
绑定到某个端口时触发的中断会导致数据包传送到该端口。
如果未绑定到端口,则可以使用 zx_interrupt_wait()
等待中断对象。
不能等待 zx_object_wait_
调用系列的中断。
权限
src_obj 必须具有资源种类 ZX_RSRC_KIND_IRQ
。
返回值
zx_interrupt_create()
会在成功时返回 ZX_OK
。如果失败,则返回负的错误值。
错误
ZX_ERR_BAD_HANDLE
src_obj 句柄无效(如果这不是虚拟中断)
ZX_ERR_WRONG_TYPE
src_obj 句柄的类型不适合创建中断。
ZX_ERR_ACCESS_DENIED
src_obj 句柄不允许执行此操作。
ZX_ERR_INVALID_ARGS
options 包含无效标志,或 out_handle 参数是无效的指针。
ZX_ERR_NO_MEMORY
由于内存不足而失败。
用户空间没有什么方法来处理此(不太可能)错误。在以后的 build 中,此错误不会再发生。
另请参阅
zx_handle_close()
zx_interrupt_ack()
zx_interrupt_bind()
zx_interrupt_destroy()
zx_interrupt_wait()
zx_port_wait()