Save_Client_State

include vmm.inc

mov     edi, Buffer
VMMcall Save_Client_State

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. Uses Flags.

• No return value.

Buffer

Address of the buffer to receive the client state. The buffer must have the same size as a Client_Reg_Struc structure.

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.

This service is typically not called directly; a virtual device typically uses the Push_Client_State macro which, in turn, calls this service.

See also Begin_Nest_Exec, Begin_Nest_V86_Exec, Client_Reg_Struc, Restore_Client_State