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_GrbMem
                                                     Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
include vdd.inc
 
VxDcall VDD_Get_GrbMem
 
The VDD_Get_GrbMem service return the flat address and allocation bitmap for
virtual machine's video memory. This service returns the address of the copy
of the memory that was made by the grab routine.
 
Parameter   Description
────────────────────────────────────────────────────────────────────────────
 
EDX         Specifies the system virtual machine handle.
 
EBX         Specifies the handle of the virtual machine to retrieve the
            memory 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 VDA_Mem_State.
 
Client_EDI  Specifies the address of the buffer to receive the
            VDA_Mem_State.
 
Client_CX   Specifies the size of the buffer to hold the VDA_Mem_State. This
            is for debugging only.
 
Return Value
 
The Client_CX register contains the number of bytes copied to the buffer.
Otherwise, it is zero to indicate an error such as the buffer is too small,
an invalid selector, or a call to VDD_Get_GrbMem when no grab is active.
 
Comments
 
The allocation of memory to the bitmap is dynamic. The grabber must call
this service each time it accesses the memory.
 
Uses
 
Flags
 
                                      ♦