Zx_vcpu_kick

摘要

啟動 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 的控制代碼。

另請參閱