__vmx_vmclear

Microsoft 特定的

初始化指定的虛擬機器控制結構（VMCS），並將其啟動狀態設定為 Clear 。

語法

unsigned char __vmx_vmclear(
   unsigned __int64 *VmcsPhysicalAddress
);

VmcsPhysicalAddress
[in]64 位記憶體位置的指標，其中包含要清除之 VMCS 的實體位址。

值	意義
0	作業成功。
1	作業失敗，在目前 VMCS的 `VM-instruction error field` 中有擴充狀態。
2	作業失敗，無可用的狀態。

應用程式可以使用 __vmx_vmlaunch 或 __vmx_vmresume 函式來執行 VM 輸入作業。 __vmx_vmlaunch 函式只能與啟動狀態為 Clear 的 VMCS 搭配使用，而__vmx_vmresume 函式只能與啟動狀態為 Launched 的 VMCS 搭配使用。因此，使用 __vmx_vmclear 函式，將 VMCS 的啟動狀態設定為 Clear 。針對第一個 VM 輸入作業使用__vmx_vmlaunch 函式，以及後續 VM 輸入作業的__vmx_vmresume 函式。

__vmx_vmclear 函式相當於 VMCLEAR 機器指令。這個函式支援主機虛擬機器監視器與客體作業系統及其應用程式的互動。如需詳細資訊，請在 Intel Corporation 網站搜尋檔「IA-32 Intel Architecture 的 Intel 虛擬化技術規格」檔編號 C97063-002 。

內建	架構
`__vmx_vmclear`	x64

標頭檔 < intrin.h>

END Microsoft 特定的