zx_break_作業

摘要

刪除中斷物件。

宣告

#include <zircon/syscalls.h>

zx_status_t zx_interrupt_destroy(zx_handle_t handle);

說明

zx_interrupt_destroy()「毀壞」將中斷物件放進狀態 其中任何 zx_interrupt_wait() 作業都會傳回 ZX_ERR_CANCELED 且未繫結至任何繫結的通訊埠。

這可提供簡潔的關閉機制。關閉最後一個控點 中斷物件會導致類似的取消作業，但可能會導致關閉後使用 控點。

如果在取消作業發生時，中斷物件已繫結至通訊埠 尚未觸發，或已觸發，但封包尚未觸發 並由 zx_port_wait() 的呼叫端接收，會傳回成功和所有封包 。如果沒有，則會傳回 ZX_ERR_NOT_FOUND，表示 表示封包已讀取，但中斷工作，不會再次透過呼叫 zx_interrupt_ack()。

權限

TODO(https://fxbug.dev/42107318)

傳回值

zx_interrupt_destroy() 會在成功時傳回 ZX_OK。活動 失敗時，系統會傳回負錯誤值。

錯誤

ZX_ERR_BAD_HANDLE 帳號代碼是無效的帳號代碼。

ZX_ERR_WRONG_TYPE 處理常式不是中斷物件。

ZX_ERR_NOT_FOUND 帳號代碼已繫結 (且現在不再)，但並未 等待的時間

ZX_ERR_ACCESS_DENIED 帳號代碼缺少 ZX_RIGHT_WRITE。

另請參閱