摘要
啟動 vCPU 並停止執行。
宣告
#include <zircon/syscalls.h>
zx_status_t zx_vcpu_kick(zx_handle_t handle);
說明
zx_vcpu_kick()
會強制在帳號代碼上目前或下次執行 zx_vcpu_enter()
時傳回 ZX_ERR_CANCELED
。
系統會在「帳號代碼」上多次呼叫 zx_vcpu_kick()
,但只會影響目前或下次的 zx_vcpu_enter()
執行作業。
權限
handle 必須是 ZX_OBJ_TYPE_VCPU
類型,且具有 ZX_RIGHT_EXECUTE
。
傳回值
zx_vcpu_kick()
會在成功時傳回 ZX_OK
。失敗時,系統會傳回錯誤值。
錯誤
ZX_ERR_ACCESS_DENIED
處理常式沒有 ZX_RIGHT_EXECUTE
權利。
ZX_ERR_BAD_HANDLE
帳號代碼是無效的帳號代碼。
ZX_ERR_WRONG_TYPE
處理常式不是 vCPU 的控制代碼。
另請參閱
zx_guest_create()
zx_guest_set_trap()
zx_vcpu_create()
zx_vcpu_enter()
zx_vcpu_interrupt()
zx_vcpu_read_state()
zx_vcpu_write_state()