__vmx_vmclear

Microsoft-spezifisch

Initialisiert die angegebene Vm-Steuerungsstruktur (VMCS) und legt den Startzustand auf Clear.

Syntax

unsigned char __vmx_vmclear(
   unsigned __int64 *VmcsPhysicalAddress
);

Parameter

VmcsPhysicalAddress
[in] Ein Zeiger auf einen 64-Bit-Speicherspeicherort, der die physische Adresse des zu löschenden VMCS enthält.

Rückgabewert

Wert Bedeutung
0 Der Vorgang war erfolgreich.
1 Bei dem Vorgang ist ein Fehler mit erweitertem Status aufgetreten, der im VM-instruction error field der aktuellen VMCS verfügbar ist.
2 Bei dem Vorgang ist ein Fehler ohne verfügbaren Status aufgetreten.

Hinweise

Eine Anwendung kann einen VM-Enter-Vorgang entweder mithilfe der __vmx_vmlaunch - oder __vmx_vmresume-Funktion ausführen. Die __vmx_vmlaunch-Funktion kann nur mit einem VMCS verwendet werden, dessen Startzustand lautet Clear, und die __vmx_vmresume-Funktion kann nur mit einem VMCS verwendet werden, dessen Startzustand lautet Launched. Verwenden Sie daher die __vmx_vmclear-Funktion , um den Startzustand eines virtuellen Computers auf festzulegen Clear. Verwenden Sie die __vmx_vmlaunch-Funktion für den ersten VM-Enter-Vorgang und die __vmx_vmresume-Funktion für nachfolgende VM-Eingabevorgänge.

Die __vmx_vmclear -Funktion entspricht der VMCLEAR -Computeranweisung. Diese Funktion unterstützt die Interaktion zwischen dem Monitor des virtuellen Computers eines Hosts mit einem Gastbetriebssystem und seinen Anwendungen. Weitere Informationen finden Sie im Dokument "Intel Virtualization Technical Specification for the IA-32 Intel Architecture", Dokumentnummer C97063-002 auf der Website der Intel Corporation .

Anforderungen

Intrinsic Aufbau
__vmx_vmclear x64

Headerdatei<intrin.h>

Ende Microsoft-spezifisch

Siehe auch

Systeminterne Compiler
__vmx_vmlaunch
__vmx_vmresume