__vmx_vmclear
Microsoft Specific
Initializes the specified virtual machine control structure (VMCS) and sets its launch state to Clear
.
Syntax
unsigned char __vmx_vmclear(
unsigned __int64 *VmcsPhysicalAddress
);
Parameters
VmcsPhysicalAddress
[in] A pointer to a 64-bit memory location that contains the physical address of the VMCS to clear.
Return value
Value | Meaning |
---|---|
0 | The operation succeeded. |
1 | The operation failed with extended status available in the VM-instruction error field of the current VMCS. |
2 | The operation failed without status available. |
Remarks
An application can perform a VM-enter operation by using either the __vmx_vmlaunch or __vmx_vmresume function. The __vmx_vmlaunch function can be used only with a VMCS whose launch state is Clear
, and the __vmx_vmresume function can be used only with a VMCS whose launch state is Launched
. Consequently, use the __vmx_vmclear function to set the launch state of a VMCS to Clear
. Use the __vmx_vmlaunch function for your first VM-enter operation and the __vmx_vmresume function for subsequent VM-enter operations.
The __vmx_vmclear
function is equivalent to the VMCLEAR
machine instruction. This function supports the interaction of a host's virtual machine monitor with a guest operating system and its applications. For more information, search for the document, "Intel Virtualization Technical Specification for the IA-32 Intel Architecture," document number C97063-002, at the Intel Corporation site.
Requirements
Intrinsic | Architecture |
---|---|
__vmx_vmclear |
x64 |
Header file <intrin.h>
END Microsoft Specific
See also
Feedback
https://aka.ms/ContentUserFeedback.
În curând: Pe parcursul anului 2024, vom elimina treptat Probleme legate de GitHub ca mecanism de feedback pentru conținut și îl vom înlocui cu un nou sistem de feedback. Pentru mai multe informații, consultați:Trimiteți și vizualizați feedback pentru