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_Deallocate
                                                     Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
include vmm.inc
 
mov     esi, List       ; list handle
mov     eax, Node       ; address of node to deallocate
VMMcall List_Deallocate
 
The List_Deallocate service deallocates the specified node. Once a virtual
device deallocates a node, it must not attempt to use the node.
 
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
 
This service normally never destroys a node. Instead, the service places the
node back in the free pool. The node can then quickly be reclaimed when the
List_Allocate service is called. If the list is created using the
LF_Use_Heap value, this service calls the _HeapFree service for each node.
 
Uses
 
EAX, Flags
 
See Also
 
_HeapFree, List_Allocate, List_Create