__vmx_vmclear

Seção específica da Microsoft

Inicializa a VMCS (estrutura de controle de máquina virtual) especificada e define seu estado de inicialização como Clear.

Sintaxe

unsigned char __vmx_vmclear(
   unsigned __int64 *VmcsPhysicalAddress
);

Parâmetros

VmcsPhysicalAddress
[in] Um ponteiro para um local de memória de 64 bits que contém o endereço físico da VMCS a limpar.

Valor retornado

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

Comentários

Um aplicativo pode executar uma operação de entrada de VM usando a função __vmx_vmlaunch ou __vmx_vmresume. A função __vmx_vmlaunch só pode ser usada com um VMCS cujo estado de inicialização é Clear, e a função __vmx_vmresume pode ser usada apenas com um VMCS cujo estado de inicialização é Launched. Consequentemente, use a função __vmx_vmclear para definir o estado de inicialização de uma VMCS como Clear. Use a função __vmx_vmlaunch para sua primeira operação de entrada de VM e a função __vmx_vmresume para operações de entrada de VM posteriores.

A função __vmx_vmclear é equivalente à instrução do computador VMCLEAR. Essa função dá suporte à interação do monitor de máquina virtual de um host com um sistema operacional convidado e os respectivos aplicativos. Para obter mais informações, pesquise o documento "Especificação técnica de virtualização intel para a arquitetura intel IA-32", número do documento C97063-002, no site da Intel Corporation.

Requisitos

Intrinsic	Arquitetura
__vmx_vmclear	x64

Arquivo de cabeçalho<intrin.h>

Fim da seção específica da Microsoft

Confira também

Compilador intrínsecos
__vmx_vmlaunch
__vmx_vmresume