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.
VDD_Get_State
                                                     Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
include vdd.inc
 
VxDcall VDD_Get_State
 
The VDD_Get_State service returns the current state of the virtual machine.
This service should be called after a call to the VDD_Get_Mem service buts
before calling the VDD_Free_Mem service.
 
This service is called by the grabber.
 
Parameter   Description
────────────────────────────────────────────────────────────────────────────
 
EDX         Specifies the system virtual machine handle.
 
EBX         Specifies the handle of the virtual machine to retrieve the
            change list for.
 
EDI         Specifies the VDD control block pointer.
 
EBP         Points to the Client_Reg_Struc structure for the virtual
            machine.
 
Client_EBX  Specifies the virtual machine handle.
 
Client_ES   Specifies the selector identifying the segment containing the
            buffer to receive the state.
 
Client_EDI  Specifies the address of the buffer to receive the state.
 
Client_CX   Specifies the size of the buffer to receive the state. This is
            for debugging only.
 
Return Value
 
The Client_CX register contains the size of structure returned by the
service (for debugging only). The service returns zero to indicate an
error.
 
Comments
 
This service returns a video state structure. See the VDD.INC file for the
structure definition.
 
Uses
 
Flags, Client_CX
 
                                      ♦