摘要
等待中斷。
宣告
#include <zircon/syscalls.h>
zx_status_t zx_interrupt_wait(zx_handle_t handle, zx_time_t* out_timestamp);
說明
zx_interrupt_wait()
是封鎖式系統呼叫,會讓呼叫端等待,直到觸發中斷為止。只能用於未使用 zx_interrupt_bind()
繫結至通訊埠的中斷物件
在等待開始之前,也會確認中斷物件,就像對其呼叫 zx_interrupt_ack()
一樣。
您可以使用 zx_interrupt_destroy()
或關閉句柄來中斷等待。
權限
handle 必須是 ZX_OBJ_TYPE_INTERRUPT
類型,且具有 ZX_RIGHT_WAIT
。
傳回值
zx_interrupt_wait()
會在成功時傳回 ZX_OK
,如果 out_timestamp 非空值,則會傳回觸發中斷時間的時間戳記。根據預設,這個時間戳記是相對於 ZX_CLOCK_BOOT
。不過,如果中斷事件是使用 ZX_INTERRUPT_TIMESTAMP_MONO
旗標建立,這個時間戳記會相對於 ZX_CLOCK_MONOTONIC
。
錯誤
ZX_ERR_BAD_HANDLE
handle 是無效的 handle。
ZX_ERR_WRONG_TYPE
handle 不是中斷物件的 handle。
ZX_ERR_BAD_STATE
中斷物件已繫結至通訊埠。
ZX_ERR_ACCESS_DENIED
handle 缺少 ZX_RIGHT_WAIT
。
ZX_ERR_CANCELED
handle 在等待期間關閉,或是 zx_interrupt_destroy()
在該 handle 上呼叫。
ZX_ERR_INVALID_ARGS
out_timestamp 參數是無效的指標。
另請參閱
zx_handle_close()
zx_interrupt_ack()
zx_interrupt_bind()
zx_interrupt_create()
zx_interrupt_destroy()
zx_interrupt_trigger()
zx_port_wait()