Virtual Devices (3.1) (vdag31qh.hlp) (Table of Contents; Topic list)
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.
List_Remove_First
                                                     Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
include vmm.inc
 
mov     esi, List       ; list handle
VMMcall List_Remove_First
 
jz      list_empty      ; zero flag set if list is empty
mov     [Node], eax     ; address of node removed
 
The List_Remove_First service removes the first node from a list.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
List       Specifies the handle identifying a list. The handle must have
           been previously created using the List_Create service.
 
Return Value
 
If the zero flag is clear, the EAX register contains the address of the node
that was removed. If the list is empty, the zero flag is set and EAX
contains zero.
 
Comments
 
This service does not deallocate the node. It is up to the virtual device to
deallocate the node or attach it to another list.
 
Uses
 
EAX, Flags
 
See Also
 
List_Create, List_Remove