zx_vcpu_write_state

摘要

寫入 vCPU 的狀態。

宣告

#include <zircon/syscalls.h>

zx_status_t zx_vcpu_write_state(zx_handle_t handle,
                                uint32_t kind,
                                const void* buffer,
                                size_t buffer_size);

說明

zx_vcpu_write_state() 會根據緩衝區中的 Kind 指定，寫入控制代碼的狀態。只有在暫停執行時，才能寫入 handle 的狀態。

「Kind」可以是 ZX_VCPU_STATE 或 ZX_VCPU_IO。

zx_vcpu_write_state() 必須透過建立時所在的執行緒處理常式呼叫。

權限

handle 必須是 ZX_OBJ_TYPE_VCPU 類型，且具有 ZX_RIGHT_WRITE。

傳回值

zx_vcpu_write_state() 會在成功時傳回 ZX_OK。失敗時，系統會傳回錯誤值。

錯誤

ZX_ERR_ACCESS_DENIED 處理常式沒有 ZX_RIGHT_WRITE 權利。

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

ZX_ERR_BAD_STATE 處理常式處於不良狀態，因此無法寫入狀態。

ZX_ERR_INVALID_ARGS Kind 並非為已知的 vCPU 狀態命名，buffer 為無效指標，或 buffer_size 與預期的大小不符。

ZX_ERR_WRONG_TYPE 處理常式不是 vCPU 的控制代碼。

另請參閱