zx_vcpu_kick

摘要

提升 vCPU 数量，使其停止执行。

声明

#include <zircon/syscalls.h>

zx_status_t zx_vcpu_kick(zx_handle_t handle);

说明

zx_vcpu_kick() 将 zx_vcpu_enter() 当前或下次执行强制设置为 handle 以立即返回 ZX_ERR_CANCELED。

可以在 handle 上多次调用 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 handle 是无效的句柄。

ZX_ERR_WRONG_TYPE handle 不是 vCPU 的句柄。

另请参阅