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.
Save_Client_State
                                                     Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
include vmm.inc
 
mov     edi, Buffer         ; points to the buffer to receive client state
VMMcall Save_Client_State
 
The Save_Client_State service copies the contents of the current virtual
machine's Client_Reg_Struc structure to the specified buffer. The saved
state can later be restored by calling the Restore_Client_State service.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
Buffer     Points to the buffer to receive the client state. The buffer must
           have the same size as a Client_Reg_Struc structure.
 
Return Value
 
This service has no return value.
 
Comments
 
Virtual devices typically use this service to save client registers prior to
creating a nested execution block with the Begin_Nest_Exec or
Begin_Nest_V86_Exec service.
 
Never attempt to restore the client state by directly copying saved register
values back to the Client_Reg_Struc structure; this will almost certainly
cause the virtual machine manager to crash.
 
Uses
 
Flags
 
See Also
 
Restore_Client_State