__vmx_vmclear
Sezione specifica Microsoft
Inizializza la struttura di controllo della macchina virtuale specificata (VMCS) e imposta lo stato di avvio su Clear
.
Sintassi
unsigned char __vmx_vmclear(
unsigned __int64 *VmcsPhysicalAddress
);
Parametri
VmcsPhysicalAddress
[in] Puntatore a un percorso di memoria a 64 bit che contiene l'indirizzo fisico del vmCS da cancellare.
Valore restituito
Valore | Significato |
---|---|
0 | Operazione completata. |
1 | Operazione non riuscita con stato esteso disponibile in VM-instruction error field della VMCS corrente. |
2 | Operazione non riuscita senza stato disponibile. |
Osservazioni:
Un'applicazione può eseguire un'operazione di immissione della macchina virtuale usando la funzione __vmx_vmlaunch o __vmx_vmresume . La funzione __vmx_vmlaunch può essere usata solo con un VMCS il cui stato di avvio è Clear
e la funzione __vmx_vmresume può essere usata solo con un VMCS il cui stato di avvio è Launched
. Di conseguenza, usare la funzione __vmx_vmclear per impostare lo stato di avvio di un VMCS su Clear
. Usare la funzione __vmx_vmlaunch per la prima operazione vm-enter e la funzione __vmx_vmresume per le successive operazioni di immissione della macchina virtuale.
La funzione __vmx_vmclear
è equivalente alle VMCLEAR
istruzioni in linguaggio macchina. Questa funzione supporta l'interazione di monitoraggio della macchina virtuale di un host con un sistema operativo guest e le relative applicazioni. Per altre informazioni, cercare il documento "Intel Virtualization Technical Specification for the IA-32 Intel Architecture", il numero di documento C97063-002, nel sito Intel Corporation .
Requisiti
Intrinsic | Architettura |
---|---|
__vmx_vmclear |
x64 |
<File di intestazione intrin.h>
Fine sezione specifica Microsoft