Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                                     ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
include vmm.inc
 
mov     ebx, VM           ; VM handle
VMMcall Get_Next_VM_Handle
 
mov     [NextVM], ebx     ; next VM handle
 
The Get_Next_VM_Handle service returns the handle of the next virtual
machine in the virtual machine list maintained by the system. Although each
virtual machine appears only once in the list, the order of the handles is
not guaranteed. The list is circular, so a virtual device scanning the list
should stop scanning when the latest handle returned is equal to the first
handle returned.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
VM         Specifies a handle identifying a virtual machine.
 
Return Value
 
The EBX register contains the handle of the next virtual machine in the
list.
 
Example
 
The following example modifies the state of every virtual machine by using
the Get_Next_VM_Handle service to retrieve handles of all valid virtual
machines:
 
    VMMcall Get_Cur_VM_Handle
 
Scan_Loop:
 
    ; modify the VM state
 
    VMMcall Get_Next_VM_Handle
    VMMcall Test_Cur_VM_Handle
    jne     Scan_Loop
 
Uses
 
EBX, Flags
 
See Also
 
Get_Cur_VM_Handle, Test_Cur_VM_Handle
 
 
                                      ♦