SHELL_GetVMInfo

include shell.inc

VxDcall SHELL_GetVMInfo


The SHELL_GetVMInfo service allows a virtual device to retrieve PIF information settings for a virtual machine.

This service is only available for Windows version 3.1 and later.

Parameters

EBX

Specifies the handle of the virtual machine to examine.

Return Value

The EAX register contains one or more of the following flag values for the specified virtual machine:

Value Meaning

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 ECX, EDX, ESI, and EDI register contents are reserved.

Comments

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

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.

Uses

EAX, ECX, EDI, EDX, ESI, Flags