Freigeben über


__vmx_vmclear

Microsoft-spezifisch

Initialisiert die angegebene Kontrollstruktur des virtuellen Computers (VMCS) und legt dessen Startzustand zu Clear.

unsigned char __vmx_vmclear(
   unsigned __int64 *VmcsPhysicalAddress
);

Parameter

Parameter

Beschreibung

[in] VmcsPhysicalAddress

Ein Zeiger auf eine 64-Bit-Speicheradresse, die die physische Adresse des VMCS enthält, die gelöscht werden soll.

Rückgabewert

Wert

Bedeutung

0

Der Vorgang war erfolgreich.

1

Der Vorgang fehlgeschlagen ist mit dem erweiterten Status verfügbar in VM-instruction error field des aktuellen VMCS.

2

Der Vorgang fehlgeschlagen ist, ohne den Status verfügbar.

Hinweise

Eine Anwendung kann einen VM-ENTER-Vorgang ausführen, indem sie entweder __vmx_vmlaunch oder __vmx_vmresume-Funktion verwendet. Die __vmx_vmlaunch-Funktion kann nur mit einem VMCS verwendet werden, dessen Startzustand Clear ist, und die __vmx_vmresume-Funktion kann nur mit einem VMCS verwendet werden, dessen Startzustand Launched ist. Infolgedessen verwenden Sie die __vmx_vmclear-Funktion, um den Startzustand eines VMCS zu Clear festzulegen. Verwenden Sie die __vmx_vmlaunch-Funktion für den ersten VM-ENTER-Vorgang und die __vmx_vmresume-Funktion für folgende VM-ENTER-Vorgänge.

Die __vmx_vmclear-Funktion ähnelt dem VMCLEAR Computeranweisung. Diese Funktion unterstützt die Interaktion des Bildschirms des virtuellen Computers eines Hosts mit einem Betriebssystem Gast und ihren Anwendungen. Weitere Informationen zur Suche für das Dokument "Intel-Virtualisierungs-technische Spezifikation für die Architektur, Intel IA-32" Belegnummer C97063-002, an der Website Intel Corporation.

Anforderungen

Intrinsisch

Architektur

__vmx_vmclear

x64

Headerdatei <intrin.h>

Siehe auch

Referenz

Intrinsische Compilerfunktionen

__vmx_vmlaunch

__vmx_vmresume