zx_vcpu_kick
Summary
Kick a VCPU, causing it to stop execution.
Declaration
#include <zircon/syscalls.h>
zx_status_t zx_vcpu_kick(zx_handle_t handle);
Description
zx_vcpu_kick()
forces the current or next execution of zx_vcpu_enter()
on
handle to return immediately with ZX_ERR_CANCELED
.
zx_vcpu_kick()
may be called multiple times on handle, but will only affect
the current or next execution of zx_vcpu_enter()
.
Rights
handle must be of type ZX_OBJ_TYPE_VCPU
and have ZX_RIGHT_EXECUTE
.
Return value
zx_vcpu_kick()
returns ZX_OK
on success. On failure, an error value is
returned.
Errors
ZX_ERR_ACCESS_DENIED
handle does not have the ZX_RIGHT_EXECUTE
right.
ZX_ERR_BAD_HANDLE
handle is an invalid handle.
ZX_ERR_WRONG_TYPE
handle is not a handle to a VCPU.
See also
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-03-04 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-03-04 UTC."],[],[]]