Intel ITANIUM ARCHITECTURE - SOFTWARE DEVELOPERS MANUAL VOLUME 1 REV 2.3 Manual page 719

PAL_VP_CREATE – PAL Create New Virtual Processor (265)
Initializes a new vpd for the operation of a new virtual processor in the virtual
Purpose:
environment.
Stacked Registers
Calling Conv:
Virtual
Mode:
Dependent
Buffer:
Arguments:
Argument
index
vpd
host_iva
opt_handler
Returns:
Return Value
status
Reserved
Reserved
Reserved
Status:
Status Value
0
-1
-2
-3
-9
Initializes a new vpd for the operation of a new virtual processor within the virtual
Description:
environment.
The caller must pass a pointer to the new Virtual Processor Descriptor (vpd) as
argument. The host virtual to host physical translation of the 64K region specified by
vpd must be mapped with either a DTR or DTC. See
Procedure Calls in Physical or Virtual Mode" on page 2:359
translation requirements of memory buffer pointers passed as arguments to PAL
procedures. The vac, vdc and virt_env_vaddr parameters in the VPD must already be
initialized before calling this procedure. Invalid argument is returned on unsupported
vac/vdc combinations. See
on page 2:349
The host_iva parameter specifies the host IVT to handle IVA-based interruptions when
this virtual processor is running. The VMM can use the same or different host_iva for
each virtual processor. The opt_handler specifies an optional virtualization intercept
handler. If a non-zero value is specified, all virtualization intercepts are delivered to this
handler. If a zero value is specified, all virtualization intercepts are delivered to the
Virtualization vector in the host IVT. If the VMM relocates the IVT specified by the
host_iva parameter and/or the virtualization intercept handler specified by the
opt_handler parameter after this procedure, PAL_VP_REGISTER must be called to
register the new host IVT and virtualization intercept handler before resuming virtual
processor execution or allowing any IVA-based interruptions to occur; otherwise
processor operation is undefined.
Upon return, the VMM is responsible for setting up the rest of the VMD state before the
new virtual processor is launched (via PAL_VPS_RESUME_NORMAL or
PAL_VPS_RESUME_HANDLER).
Volume 2, Part 1: Processor Abstraction Layer
Description
Index of PAL_VP_CREATE within the list of PAL procedures
64-bit host virtual pointer to the Virtual Processor Descriptor (VPD)
64-bit host virtual pointer to the host IVT for the virtual processor
64-bit non-zero host-virtual pointer to an optional handler for virtualization intercepts. See
Section 11.7.3, "PAL Intercepts in Virtual Environment" on page 2:332
Description
Return status of the PAL_VP_CREATE procedure
0
0
0
Description
Call completed without error
Unimplemented procedure
Invalid argument
Call completed with error
Call requires PAL memory buffer
Section 11.7.4.4, "Virtualization Optimization Combinations"
for details.
PAL_VP_CREATE
for details.
Section 11.10.2.1.3, "Making PAL
for details on data
2:471