摘要
等待中斷。
宣告
#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 參數是無效的指標。