__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