SHELL_GetVMInfo

include shell.inc
mov ebx, Handle   ; virtual machine handle
VxDcall SHELL_GetVMInfo

mov [hwnd], dx    ; WinOldAp window handle for VM
mov [Flags], eax  ; flags for virtual machine

Retrieves PIF information settings for a virtual machine. This service is only available for Windows version 3.1 and later. Uses EAX, ECX, EDI, EDX, ESI, and Flags.

Sets the DX register to the handle of the WinOldAp window corresponding to the VM and sets the EAX register to one or more of these flag values:

SGVMI_ALTENTERdis	ALT+ENTER is reserved.
SGVMI_ALTESCdis	ALT+ESC is reserved.
SGVMI_ALTPRTSCdis	ALT+PRTSC is reserved.
SGVMI_ALTSPACEdis	ALT+SPACEBAR is reserved.
SGVMI_ALTTABdis	ALT+TAB is reserved.
SGVMI_ClsExit	Close on exit enabled.
SGVMI_CTRLESCdis	CTRL+ESC is reserved.
SGVMI_EMS_Lock	EMS hands locked.
SGVMI_FastPaste	Allow fast paste enabled.
SGVMI_HasHotKey	Has a shortcut key.
SGVMI_NoHMA	No HMA.
SGVMI_Polling	Polling detection enabled.
SGVMI_PRTSCdis	PRTSC is reserved.
SGVMI_V86_Lock	V86 memory locked.
SGVMI_Windowed	The virtual machine runs in a window.
SGVMI_XMS_Lock	XMS hands locked.

The undefined bits in the EAX register are reserved. Do not depend on them being zero. The high 16 bits of the EDX register are reserved.

Handle

Handle of the virtual machine to examine.

This service is not valid until after all virtual devices have processed the Create_VM message. This service if called during a Create_VM message will not return proper PIF information. The ECX, EDX, ESI, and EDI register contents are reserved.