zx_break_wait

摘要

等待中斷。

宣告

#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 參數是無效的指標。

另請參閱