List_Attach

include vmm.inc

mov     esi, List       ; list handle
mov     eax, Node       ; address of node to attach
VMMCall List_Attach
 

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 and was created with the same flags. (It is an error, for example, to attach a node allocated from a list created as LF_Use_Heap to a list created without that flag, even if the node sizes agree.) This service can be used, for example, to move a node from one list to another. Uses Flags.

• No return value.

List

Handle of the list. The handle must have been previously created using the List_Create service.

Node

Address of the node to attach. The node must have been previously created using the List_Allocate service.

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.

See Also

List_Allocate, List_Create, List_Get_First, List_Get_Next, List_Remove, List_Remove_First