This documentation is archived and is not being maintained.


Microsoft Specific

This topic is new for Visual Studio 2005 SP1.

Reads a specified field from the current virtual machine control structure (VMCS) and places it in the specified location.

unsigned char __vmx_vmread(
   size_t Field,
   size_t *FieldValue


Parameter Description

[in] Field

The VMCS field to read.

[in] FieldValue

A pointer to the location to store the value read from the VMCS field specified by the Field parameter.

Value Meaning


The operation succeeded.


The operation failed with extended status available in the VM-instruction error field of the current VMCS.


The operation failed without status available.

The __vmx_vmread function is equivalent to the VMREAD machine instruction. The value of the Field parameter is an encoded field index that is described in Intel documentation. For more information, search for the document, "Intel Virtualization Technical Specification for the IA-32 Intel Architecture," document number C97063-002, at the Intel Corporation site, then consult Appendix C of that document.

Intrinsic Architecture



Header file <intrin.h>

END Microsoft Specific