Virtual Machine control structure (VMCS) Field IDs

Identify the fields of the virtual machine control structure.

Overview

Used by the functions hv_vmx_vcpu_read_vmcs(_:_:_:) and hv_vmx_vcpu_write_vmcs(_:_:_:). The VMCS fields are read-only or read-write by the Hypervisor framework, according to the following table:

Readable and Writable VMCS Fields - Guest Fields

Guest	Field
RIP, RSP, RFLAGS
CR3, CR4, DR7
Selector	{ES, CS, SS, DS, FS, GS, LDTR, TR}
Base	{ES, CS, SS, DS, FS, GS, LDTR, TR, GDTR, IDTR}
Limit	{ES, CS, SS, DS, FS, GS, LDTR, TR, GDTR, IDTR}
Access Rights	{ES, CS, SS, DS, FS, GS, LDTR, TR}
PDPTE	{0, 1, 2, 3}
CR3-Target	{0, 1, 2, 3}
IA32_SYSENTER_CS
IA32_SYSENTER_ESP
IA32_SYSENTER_EIP
IA32_EFER
Interruptibility State
Pending Debug Exceptions

Readable and Writable VMCS Fields - Control Fields

Control Field
Exception Bitmap
Page-Fault Error-Code Mask
VM-Entry Interruption-Information Field
VM-Entry Exception Error Code
VM-Entry Instruction Length
TPR Threshold
PLE Gap
PLE Window
CR0 Guest/Host Mask
CR4 Guest/Host Mask
CR0 Read Shadow
CR4 Read Shadow

Readable and Conditionally Writable VMCS Fields - Guest Fields

Guest Field	Condition
CR0	CR0.CD and CR0.NW are unset
Activity State	ACTIVE or HLT

Readable and Conditionally Writable VMCS Fields - Control Fields

Control Field	Condition
CR0 Guest/Host Mask	CR0.CD and CR0.NW are set
Pin-Based VM-Execution Controls	Hv_vmx_read_capability(_:_:) returns true
Primary Processor-Based VM-ExecutionControls	Hv_vmx_read_capability(_:_:) returns true
Secondary Processor-Based VM-ExecutionControls	Hv_vmx_read_capability(_:_:) returns true
VM-Entry Controls	Hv_vmx_read_capability(_:_:) returns true

Read-Only VMCS Fields - Control Fields

Control Field
TSC Offset
APIC-Access Address

Read-Only VMCS Fields - Data Fields

Data Fields
VM-Instruction Error
Exit Reason
VM-Exit Interruption Information
VM-Exit Interruption Error Code
IDT-Vectoring Information Field
IDT-Vectoring Error Code
VM-Exit Instruction Length
VM-Exit Instruction Information
Guest-Physical Address
Exit Qualification
Guest-Linear Address