Begin_PM

Begin_PM_App

include vmm.inc

mov     ebx, VMHandle
mov     edx, Flags
mov     edi, OFFSET32 acb
mov     eax, Begin_PM_App
VMMcall System_Control

Notifies the virtual device that the system is starting a protected-mode application. The virtual device may modify all general registers and flags.

The virtual device returns with carry clear if the virtual device can support the protected-mode application. Otherwise, it returns carry set to indicate an error, in which case the program is not allowed to enter protected mode.

VMHandle

Handle of the current virtual machine.

Flags

Bitmask of flags. Only one flag is currently supported:

Value	Meaning
BPA_32_Bit	Application has 32-bit segments. If this value is not given, the application has 16-bit segments.

All other values are reserved.

abc

Address of an application control block, which is a pmcb_s structure. A virtual device can allocate memory in the application control block with the Allocate_PM_App_CB_Area service.

Protected-mode applications may nest. Virtual devices are notified for each application, and each application has its own application control block.