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_Attach
                                                     Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
include vmm.inc
 
mov     esi, List       ; list handle
mov     eax, Node       ; address of node to attach
VMMcall List_Attach
 
The List_Attach service attaches a list node to the head (front) of a list.
A virtual device can attach a node to any list that has a matching node
size. This service can be used, for example, to move a node from one list to
another.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
List       Specifies the handle identifying a list. The handle must have
           been previously created using the List_Create service.
 
Node       Specifies the address of the node to attach. The node must have
           been previously created using the List_Allocate service.
 
Return Value
 
This service has no return value.
 
Comments
 
The service attaches the node to the head of the list. Subsequent calls to
the List_Get_First service return the address of this node. The address of
the previous head of the list can be retrieved using the List_Get_Next
service.
 
Uses
 
Flags
 
See Also
 
List_Allocate, List_Create, List_Get_First, List_Get_Next, List_Remove,
List_Remove_First