Set_Device_Focus

include vmm.inc

mov ebx, VM ; VM handle

mov edx, VID ; ID of virtual device to receive focus

mov esi, Flags ; flags for device-critical focus

mov edi, AssocVM ; handle of associated VM

mov eax, Set_Device_Focus

VMMcall System_Control

The Set_Device_Focus message sets the focus of the specified virtual device to the specified virtual machine.

Parameters

VM

Specifies a handle identifying the virtual machine.

VID

Specifies the identifier for the virtual device to receive the focus. If this parameter is zero, all virtual devices receive the focus.

Flags

Specifies how to set the focus if the VID parameter is zero. This parameter can have the following value:

Value Meaning

1 Used by the virtual shell device to determine which virtual machine to set focus for. If this value is given, the AssocVM parameter may specify a virtual machine.

All other values are reserved.

AssocVM

Specifies a handle identifying a virtual machine associated with a problem. This parameter is zero if there is no such virtual machine. This parameter is used only if the Flags parameter is set to 1.

Return Value

The carry flag must be clear.

Comments

A virtual device that receives the focus should take steps, such as disabling I/O trapping, to allow the virtual machine to run as fast as possible.

Uses

Flags