SHELL_Resolve_Contention

include shell.inc
mov eax, OwnerHandle  ; virtual machine handle of device owner
mov ebx, OtherHandle  ; virtual machine handle of contender
mov esi, OFFSET32 DeviceName  ; address of device name 
VxDcall SHELL_Resolve_Contention

jc  cannot_resolve
mov [WinnerHandle], ebx  ; virtual machine handle of new owner
 

Resolves contention for the MS-DOS shell. Uses EBX and Flags.

• Clears the carry flag and copies the virtual machine handle of contention winner to the EBX register if successful. Otherwise, sets the carry flag to indicate that contention could not be resolved.

OwnerHandle

Handle of virtual machine of the current device owner.

OtherHandle

Handle of the contending virtual machine. This parameter must identify the current virtual machine.

DeviceName

Address of an 8-byte string identifying the name of the device in contention. The name must be in uppercase letters, and be padded with spaces if necessary. This string must remain valid until SHELL_Resolve_Contention returns.