__vmx_vmclear

Artigo
06/10/2015

Específicos do Microsoft

Initializes the specified virtual machine control structure (VMCS) and sets its launch state to Clear.

unsigned char __vmx_vmclear(
   unsigned __int64 *VmcsPhysicalAddress
);

Parâmetros

Parâmetro	Descrição
[in] VmcsPhysicalAddress	A pointer to a 64-bit memory location that contains the physical address of the VMCS to clear.

Valor de retorno

Valor	Significado
0	A operação foi bem-sucedida.
1	A operação falhou com status estendido disponível no VM-instruction error field de VMCS atual.
2	Falha na operação sem status disponível.

Comentários

Um aplicativo pode executar uma operação de inserir VM usando o __vmx_vmlaunch ou __vmx_vmresume função. O __vmx_vmlaunch função pode ser usada apenas com um estado cujo lançamento é de VMCS Cleare o __vmx_vmresume função pode ser usada apenas com um estado cujo lançamento é de VMCS 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. Essa função oferece suporte à interação do monitor de máquina virtual do host com um sistema operacional e seus aplicativos de convidado. Para obter mais informações, procure o documento "Intel Virtualization técnico especificação para a arquitetura IA-32 Intel," documento número C97063-002, no Intel Corporation site.